README.md in af-0.3.18.11 vs README.md in af-0.3.18.12

@@ -2,10 +2,24 @@
 
 The AppFog CLI. This is the command line interface to AppFog.com
 
 af is based on vmc but will have features specific to the AppFog service as well as having the default target set to AppFog's service
 
+## Installation
+
+There are two ways to install af. Most users should install the RubyGem.
+
+    $ sudo gem install af
+
+You can also check out the source for development. You will need [Bundler](http://gembundler.com/) to build af.
+
+    $ git clone https://github.com/appfog/af.git
+    $ cd af
+    $ bundle install
+
+## Usage
+
 _Copyright 2010-2012, VMware, Inc. Licensed under the
 MIT license, please see the LICENSE file.  All rights reserved._
 
     Usage: af [options] command [<args>] [command_options]
     Try 'af help [command]' or 'af help options' for more information.
@@ -100,9 +114,37 @@
 
     Help
       help [command]                               Get general help or help on a specific command
       help options                                 Get help on available options
 
-## Simple Story (for PHP apps)
+## Sample Usage (for PHP apps)
 
-    af login
-    af push
+    $ af login [e-mail]
+    Attempting login to [https://api.appfog.com]
+    Password: *********
+    Successfully logged into [https://api.appfog.com]
+    
+    $ af push
+    Would you like to deploy from the current directory? [Yn]: Y
+    Application Name: myapp
+    Detected a PHP Application, is this correct? [Yn]: 
+    1: AWS US East - Virginia
+    2: AWS EU West - Ireland
+    3: AWS Asia SE - Singapore
+    4: Rackspace AZ 1 - Dallas
+    5: HP AZ 2 - Las Vegas
+    Select Infrastructure: 1
+    Application Deployed URL [myapp.aws.af.cm]: 
+    Memory reservation (128M, 256M, 512M, 1G, 2G) [128M]: 
+    How many instances? [1]: 
+    Bind existing services to 'myapp'? [yN]: 
+    Create services to bind to 'myapp'? [yN]: 
+    Would you like to save this configuration? [yN]: 
+    Creating Application: OK
+    Uploading Application:
+      Checking for available resources: OK
+      Processing resources: OK
+      Packing application: OK
+      Uploading (6K): OK   
+    Push Status: OK
+    Staging Application 'myapp': OK                                          
+    Starting Application 'myapp': OK