#56 Improve documentation

move examples from unit tests to AsciiDoc

documentation/modules/ROOT/pages/examples.adoc

@@ -0,0 +1,36 @@
+= Examples
+
+'''
+
+[,java]
+----
+        InputStream inputStream = bundle()
+            .activator(HelloWorldActivator.class)
+            .add(HelloWorld.class)
+            .add(HelloWorldImpl.class)
+            .add(DsService.class)
+            .symbolicName("Hello World Bundle")
+            .set(Constants.EXPORT_PACKAGE, "")
+            .set(Constants.IMPORT_PACKAGE, "*")
+            .build(bndBuilder());
+----
+- Setting `Bundle-Activator` and `Bundle-SymbolicName` via dedicated methods
+- Adding a service with Declarative Services component annotations
+- Building with bnd builder
+
+'''
+
+[,java]
+----
+        InputStream inputStream = bundle()
+            .add(HelloWorldActivator.class)
+            .add(HelloWorld.class)
+            .add(HelloWorldImpl.class)
+            .set(Constants.BUNDLE_SYMBOLICNAME, "Hello World Bundle")
+            .set(Constants.EXPORT_PACKAGE, "demo")
+            .set(Constants.IMPORT_PACKAGE, "demo")
+            .set(Constants.BUNDLE_ACTIVATOR, HelloWorldActivator.class.getName())
+            .build(rawBuilder());
+----
+- Setting `Bundle-Activator` and `Bundle-SymbolicName` manually
+- Building with raw builder

documentation/modules/ROOT/pages/index.adoc

@@ -54,3 +54,5 @@ import static org.ops4j.pax.tinybundles.TinyBundles.bundle;
 ----
     InputStream inputStream = bundle.build();
 ----
+
+See xref:examples.adoc[] for more detailed examples showing usage of fluent API.