README.md in cloudstack-cli-0.4.0 vs README.md in cloudstack-cli-0.4.1

@@ -1,8 +1,9 @@
 # Cloudstack CLI
 
-Cloudstack CLI is a [CloudStack](http://cloudstack.apache.org/) API client written in Ruby.
+cloudstack-cli is a [CloudStack](http://cloudstack.apache.org/) API client written in Ruby.
+cloudstack-cli uses the [cloudstack_client](https://bitbucket.org/swisstxt/cloudstack_client) to talk to the Cloudstack API.
 
 ## Installation
 
 Install the cloudstack-cli gem:
 
@@ -35,30 +36,26 @@
 
 See the help screen:
 
     $ cs
 
-### Example 1
+### Example: Bootsrapping a server
 
-Bootsrap a server:
+Bootsraps a server using a template and creating port-forwarding rules for port 22 and 80.
 
-    $ cs server create server-01 --template CentOS-6.4-x64-v1.4 --offering 1cpu_1gb --port-rules 193.218.104.10:22 193.218.104.10:80
+    $ cs server create server-01 --template CentOS-6.4-x64-v1.4 --offering 1cpu_1gb --port-rules :22 :80
 
-### Example 2
+### Example: Run a any custom API command
 
-Run a custom API command:
+Run the "listAlerts" command against the Cloudstack API with an argument of type=8:
 
     $ cs command listAlerts type=8
 
-### Example 3
+### Example: Creating a complete stack of servers
 
-Create a stack of servers:
+An example stackfile looks like this (my_stackfile.json)
 
-    $ cs stack create my_stackfile.json
-
-An example stackfile looks like this
-
     {
       "name": "web_stack-a",
       "description": "Web Application Stack",
       "version": "1.0",
       "zone": "DC-BIE-1",
@@ -83,16 +80,20 @@
           "networks": "server_network, storage_network"
         }
       ]
     }
 
-### Example 4
+Create the stack of servers from above:
 
+    $ cs stack create my_stackfile.json
+
+### Example: Sort computing offerings
+
 Sort all computing offerings by CPU and Memory grouped my Domain:
 
     $ cs offering sort
 
-### Example 5
+### Example: Stop all backup routers of a given project
 
 Stop all virtual routers of project Demo (you could filter by zone too):
 (This command is helpful if you have to deploy new versions of Cloudstack when using redundant routers)
 
     $ cs router list --project Demo --status running --redundant-state BACKUP --command stop