README improvements.

1 files changed, 50 insertions, 0 deletions

diff --git a/README.rst b/README.rst
index eee07a7..876212e 100644
--- a/README.rst
+++ b/README.rst
@@ -1,3 +1,6 @@
+Pecan
+=====
+
 A WSGI object-dispatching web framework, designed to be lean and fast with few
 dependencies.
 
@@ -5,3 +8,50 @@ dependencies.
 .. |travis| image:: https://secure.travis-ci.org/dreamhost/pecan.png
 
 |travis|_
+
+Installing
+----------
+::
+    $ pip install pecan
+
+...or, for the latest (unstable) tip::
+
+    $ git clone https://github.com/dreamhost/pecan.git -b next
+    $ cd pecan && python setup.py develop
+
+Running Tests
+-------------
+::
+    $ python setup.py test
+
+Viewing Documentation
+---------------------
+`Available Online <http://pecan.readthedocs.org>`_, or to build manually::
+
+    $ cd docs && make html
+    $ open docs/build/html/index.html
+
+...or::
+
+    $ cd docs && make man
+    $ man docs/build/man/pecan.1
+
+Contributing to Pecan
+---------------------
+To fix bugs or add features to Pecan, a GitHub account is required.
+
+The general practice for contributing is to `fork Pecan
+<http://help.github.com/fork-a-repo/>`_ and make changes in the ``next``
+branch.  When you're finished, `send a pull request
+<http://help.github.com/send-pull-requests/>`_ and the developers will review
+your patch.
+
+All contributions must:
+
+    * Include accompanying tests.
+    * Include narrative and API documentation if new features are added.
+    * Be (generally) compliant with `PEP8
+      <http://www.python.org/dev/peps/pep-0008/>`_.
+    * Not break the test or build.  Before issuing a pull request, ``$ pip
+      install tox && tox`` from your source to ensure that all tests still pass
+      across multiple versions of Python.