Clean up README and add lots of comments to moderator.py
diff --git a/README b/README
index dd951a8..38f18b5 100644
--- a/README
+++ b/README
@@ -29,24 +29,24 @@
Running
=======
-First run three-legged-dance.py to get OAuth
-tokens for Buzz, which will be stored in
-buzz.dat in the working directory.
-
- $ python samples/buzz/three_legged_dance.py
-
-Then run buzz.py, which will use the apiclient
+Run buzz.py, which will use the apiclient
library to retrieve the title of the most
recent entry in Buzz and post a test message.
+The first time you run it you will be prompted
+to authorize the application to access your
+Buzz information.
$ python samples/buzz/buzz.py
After following the install directions (using setup.py or setpath.sh) you
-should be able to cd to samples/cmdline and run the code from there.
+should be able to cd to samples/buzz and run the code from there.
Third Party Libraries
-====================
+=====================
+
+These libraries should be installed when you install the client library, either
+automatically if you have setuptools installed, or manually if you do not:
http://code.google.com/p/httplib2
http://code.google.com/p/uri-templates