diff --git a/bean-service/Readme.md b/bean-service/Readme.md
index 4c2eaa9a5..c3882c547 100644
--- a/bean-service/Readme.md
+++ b/bean-service/Readme.md
@@ -1,6 +1,18 @@
-Introduction
-============
-This quickstart demonstrates the usage of the bean component.   This example shows a bean component 
+bean-service: demonstrates the usage of the bean component
+============================================
+Author: SwitchYard Team  
+Level: Beginner  
+Technologies: SwitchYard, Camel, SOAP 
+Summary: Demonstrates the usage of the bean component. 
+Target Product: FSW  
+Source: <https://github.com/jboss-switchyard/quickstarts>
+
+
+What is it?
+-----------
+This quickstart demonstrates the usage of the bean component.   
+
+This example shows a bean component 
 service, OrderService, which is provided through the OrderServiceBean, and an InventoryService which 
 is provided through the InventoryServiceBean implementation.    Orders are submitted through the 
 OrderService, and the OrderService then looks items up in the InventoryService to see if they are 
@@ -10,31 +22,42 @@ This example is invoked through a SOAP gateway binding.
 
 ![Bean Service Quickstart](https://github.com/jboss-switchyard/quickstarts/raw/master/bean-service/bean-service.jpg)
 
-Running the quickstart
-======================
 
-JBoss AS 7
-----------
+
+System requirements
+-------------------
+
+Before building and running this quick start you need:
+
+* Maven 3.0.3 or higher
+* JDK 1.6 or 1.7
+* JBoss AS 7
+
+Build and Deploy the Quickstart
+-------------------------
 1. Start JBoss AS 7 in standalone mode:
 
-        ${AS}/bin/standalone.sh
+    `${AS}/bin/standalone.sh`
 
 2. Build and deploy the Quickstart : 
 
-        mvn install -Pdeploy
+    mvn install -Pdeploy
 
-3. Submit a webservice request to invoke the SOAP gateway.  There are a number of ways to do this :
-      - Submit a request with your preferred SOAP client - src/test/resources/xml contains sample 
+Use the bundle
+-------------------
+
+Submit a webservice request to invoke the SOAP gateway.  There are a number of ways to do this :
+      * Submit a request with your preferred SOAP client - src/test/resources/xml contains sample 
         requests and the responses that you should see
-      - Use the simple bundled SOAP client and the sample request XML e.g.
+      * Use the simple bundled SOAP client and the sample request XML e.g.
 <br/>
 ```
             mvn exec:java
 ```
 <br/>
-      - SOAP-UI : Use the wsdl for this project (src/main/resources/wsdl/OrderService.wsdl) to create 
+      * SOAP-UI : Use the wsdl for this project (src/main/resources/wsdl/OrderService.wsdl) to create 
         a soap-ui project.    Use the sample request (src/test/resources/xml/soap-request.xml) as an 
-        example of a sample request.  The output below is the expected output :
+        example of a sample request.  The expected output is below:
 
 ```
 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
@@ -51,7 +74,10 @@ JBoss AS 7
 </SOAP-ENV:Envelope>
 ```
 
-4. Undeploy the quickstart:
+Undeploy the bundle
+-------------------
+
+Undeploy the quickstart:
         mvn clean -Pdeploy
 
 ## Further Reading
diff --git a/bpel-jms-binding/Readme.md b/bpel-jms-binding/Readme.md
index b45217479..a67ecaf13 100644
--- a/bpel-jms-binding/Readme.md
+++ b/bpel-jms-binding/Readme.md
@@ -1,5 +1,14 @@
-Introduction
-============
+bpel-jms-binding: demonstrates the use of a JMS binding for a BPEL service
+============================================
+Author: SwitchYard Team  
+Level: Beginner  
+Technologies: SwitchYard, BPEL, Camel  
+Summary: Demonstrates the use of a JMS binding for a BPEL service. 
+Target Product: FSW  
+Source: <https://github.com/jboss-switchyard/quickstarts>
+
+What is it?
+-----------
 This quickstart demonstrates the use of a JMS binding for a BPEL service.  Also of
 note : the Camel JMS binding in the quickstart uses WSDL as it's interface type
 instead of Java.
@@ -8,29 +17,38 @@ instead of Java.
 ![BPEL JMS Binding Quickstart](https://github.com/jboss-switchyard/quickstarts/raw/master/bpel-service/jms_binding/bpel-jms-binding.jpg)
 
 
-Running the quickstart
-======================
 
-JBoss AS 7
-----------
+System requirements
+-------------------
+Before building and running this quick start you need:
+
+* Maven 3.0.3 or higher
+* JDK 1.6 or 1.7
+* JBoss AS 7
+
+
+Build and Deploy the Quickstart
+-------------------------
 1. Start JBoss AS 7 in standalone-full mode:
 
-        ${AS}/bin/standalone.sh --server-config=standalone-full.xml
+        `${AS}/bin/standalone.sh --server-config=standalone-full.xml`
 
 2. Add JMS user using add-user.sh with username=guest, password=guestp.1, Realm=ApplicationRealm, role=guest
 
-        ${AS}/bin/add-user.sh
+        `${AS}/bin/add-user.sh`
 
-3. Build and deploy the quickstart
+3. Deploy the quickstart with
 
-        mvn install -Pdeploy
+        `mvn install -Pdeploy`
 
 4. Execute HornetQClient
 
-        mvn exec:java
+        `mvn exec:java`
+
+Use the bundle
+-------------------
+Successful case will produce the following output:
 
-Expected Output
-===============
 ```
 Message sent. Waiting for reply ...
 REPLY: 
@@ -38,6 +56,8 @@ REPLY:
   <tns:result xmlns:tns="http://www.jboss.org/bpel/examples">Hello Skippy</tns:result>
 </sayHelloResponse>
 ```
+Undeploy the bundle
+-------------------
 
-5. Undeploy the quickstart:
-        mvn clean -Pdeploy
\ No newline at end of file
+Undeploy the quickstart:
+        `mvn clean -Pdeploy`
\ No newline at end of file