@@ -6,45 +6,63 @@ A utility for arming (creating) many bees (micro EC2 in stances) to attack (load
 
 h2. Dependencies
 
-Required:
-
+* Python 2.6
 * boto
-* fabric
 * paramiko
 
-Recommended:
+h2. Installation for users
+
+<pre>
+% easy_install beeswithmachineguns
+</pre>
 
-* virtualenv
-* virtualenvwrapper
+<pre>
+% pip install beeswithmachineguns
+</pre>
 
-h2. Installation w/ virtualenvwrapper
+h2. Installation for developers (w/ virtualenv + virtualenvwrapper)
 
 <pre>
+% git clone git://github.com/newsapps/beeswithmachineguns.git
 % cd beeswithmachineguns
 % mkvirtualenv --no-site-packages bees
 % easy_install pip
 % pip install -r requirements.txt
 </pre>
 
+h2. EC2 credentials
+
+Bees uses boto to communicate with EC2 and thus supports all the methods of vstoring credentials that it does.  These include: declaring environment variables, machine-global configuration files, and per-user configuration files. You can read more about these options on "boto's configuration page":http://code.google.com/p/boto/wiki/BotoConfig
+
 h2. Usage
 
+A type bees session looks something like this:
+
 <pre>
-fab -f bees.py up:5,staging,us-east-1d
-fab -f bees.py attack:http://YOUR-DOMAIN.com/,1000,100
-fab -f bees.py down
+bees up -s 4 -g public -k frakkingtoasters
+bees attack -n 10000 -c 250 -u http://www.ournewwebbyhotness.com/
+bees down
 </pre>
 
-h2. Quirks
+This spins up 4 servers in security group 'public' using the EC2 key 'frakkingtoasters', which is expected to reside in ~/.ssh/.
 
-The AMI to clone and SSH key to use are currently hard-coded into the up() function, expect this to be fixed shortly.  In the meantime, its open-source, fork it!
+It then uses those 4 servers to send 10,000 requests, 250 at a time, to attack OurNewWebbyHotness.com.
 
-h2. Tested with
+Lastly, it spins down the 4 servers.  Please remember to do this--we aren't responsible for your EC2 bills.
 
-* Python 2.6
+For complete options type:
+
+<pre>
+bees -h
+</pre>
+
+h2. Bugs
+
+Please log your bugs on the "Github issues tracker":http://github.com/newsapps/beeswithmachineguns/issues
 
 h2. Credits
 
-A creation of the News Applications team at the Chicago Tribune--visit "our blog":http://apps.chicagotribune.com/ and read "our post about the project":http://blog.apps.chicagotribune.com/2010/07/%2008/bees-with-machine-guns/
+The bees are a creation of the News Applications team at the Chicago Tribune--visit "our blog":http://apps.chicagotribune.com/ and read "our original post about the project":http://blog.apps.chicagotribune.com/2010/07/%2008/bees-with-machine-guns/
 
 Initial refactoring code and inspiration from "Jeff Larson":http://github.com/thejefflarson