More documentation
diff --git a/decorator/Readme.md b/decorator/Readme.md
index fd62e4f..678d297 100644
--- a/decorator/Readme.md
+++ b/decorator/Readme.md
@@ -4,4 +4,4 @@
The descriptor selects services by matching interfaces and service properties and can add arbitrary service properties to it. So these services can be marked for export and configured.
-See [example descriptor](src/test/resources/sd.xml).
+See [example descriptor](src/test/resources/test-resources/sd.xml).
diff --git a/samples/Readme.md b/samples/Readme.md
index db0ca69..934384f 100644
--- a/samples/Readme.md
+++ b/samples/Readme.md
@@ -7,6 +7,29 @@
The SOAP example also provides a bndrun file for bndtools that allows to directly start/debug the service from Eclipse and export it into a runnable jar.
+## Checkout and Build
+
+```
+git clone git@github.com:apache/cxf-dosgi.git
+mvn clean install -DskipTests -Dcheckstyle.skip=true
+```
+
+This will install the examples into your local maven repo.
+
+## Editing the examples in eclipse
+
+Start eclipse and do Import .. Existing Maven Projects. Browse to the samples directory of your
+checkout and import all example projects.
+
+## Using bndtools
+
+To use the bndrun files you need the [bndtools](http://bndtools.org/) eclipse extension >= 3.3.0.
+
+## Preparing Apache Karaf
+
+[Download Apache karaf 4.x](http://karaf.apache.org/download.html). Extract the archive and
+start Apache Karaf using `bin/karaf`
+
## Examples
* [soap - Publish and Consume JAXWS SOAP services](soap)
