README.rdoc in delta-capistrano-0.1.1 vs README.rdoc in delta-capistrano-0.2.0

@@ -1,7 +1,29 @@
 = delta-capistrano
 
-Description goes here.
+Extends the capistrano DSL allowing one to run commands as a specified user as if in a shell. 
+Just require delta-capistrano in your deploy and you are good to go.
+
+
+single command: 
+
+  in_a_shell_as("u", "from argument")        
+
+  # would be equivalent of
+  sudo "sh -c 'from argument'", :as => "u"
+  
+
+multiple commands in a block:
+
+  in_a_shell_as("u") do |shell|
+    shell.run "from block once"
+    shell.run "from block twice"
+  end      
+
+  # would be equivalent of
+  sudo "sh -c 'from block once; from block twice'", :as => "u"
+  
+
 
 == Note on Patches/Pull Requests
  
 * Fork the project.
 * Make your feature addition or bug fix.