diff --git a/README.md b/README.md
index 01e0a3ee8..a25173788 100644
--- a/README.md
+++ b/README.md
@@ -38,6 +38,16 @@ Install using `pip`...
 
 **TODO**
 
+# Development
+
+To build the docs.
+
+    ./mkdocs.py
+
+To run the tests.
+
+    ./djangorestframework/runtests/runtests.py
+
 # Changelog
 
 ## 2.0.0
@@ -71,7 +81,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 
 [twitter]: https://twitter.com/_tomchristie
-[docs]: https://github.com/tomchristie/django-rest-framework/blob/restframework2/docs/index.md
+[docs]: http://tomchristie.github.com/django-rest-framework/
 [urlobject]: https://github.com/zacharyvoase/urlobject
 [markdown]: http://pypi.python.org/pypi/Markdown/
 [pyyaml]: http://pypi.python.org/pypi/PyYAML
diff --git a/djangorestframework/runtests/runtests.py b/djangorestframework/runtests/runtests.py
old mode 100644
new mode 100755
index 9f5cc7aa6..1628aff7c
--- a/djangorestframework/runtests/runtests.py
+++ b/djangorestframework/runtests/runtests.py
@@ -1,8 +1,5 @@
-'''
-Created on Mar 10, 2011
+#!/usr/bin/env python
 
-@author: tomchristie
-'''
 # http://ericholscher.com/blog/2009/jun/29/enable-setuppy-test-your-django-apps/
 # http://www.travisswicegood.com/2010/01/17/django-virtualenv-pip-and-fabric/
 # http://code.djangoproject.com/svn/django/trunk/tests/runtests.py
@@ -13,6 +10,7 @@ os.environ['DJANGO_SETTINGS_MODULE'] = 'djangorestframework.runtests.settings'
 from django.conf import settings
 from django.test.utils import get_runner
 
+
 def usage():
     return """
     Usage: python runtests.py [UnitTestClass].[method]
@@ -22,6 +20,7 @@ def usage():
     Append a method name if you only want to test a specific method of that class.
     """
 
+
 def main():
     TestRunner = get_runner(settings)
 
diff --git a/docs/index.md b/docs/index.md
index 340c67341..31bb9deb9 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -21,8 +21,6 @@ The following packages are optional:
 * [Markdown][markdown] (2.1.0+) - Markdown support for the self describing API.
 * [PyYAML][yaml] (3.10+) - YAML content type support.
 
-If you're installing using `pip`, all requirements and optional packages will be installed by default.
-
 ## Installation
 
 **WARNING: These instructions will only become valid once this becomes the master version**
@@ -89,6 +87,18 @@ General guides to using REST framework.
 * [Form overloading][formoverloading]
 * [Credits][credits]
 
+## Development
+
+If you want to work on REST framework itself, clone the repository, then...
+
+Build the docs:
+
+    ./mkdocs.py
+
+Run the tests:
+
+    ./djangorestframework/runtests/runtests.py
+
 ## License
 
 Copyright (c) 2011-2012, Tom Christie
diff --git a/docs/template.html b/docs/template.html
index a8a0d741a..e452ead73 100644
--- a/docs/template.html
+++ b/docs/template.html
@@ -102,6 +102,7 @@ margin-top: 5px;
                 <ul class="dropdown-menu">
                   <li><a href="{{ base_url }}/topics/csrf{{ suffix }}">Working with AJAX and CSRF</a></li>
                   <li><a href="{{ base_url }}/topics/formoverloading{{ suffix }}">Browser based PUT, PATCH and DELETE</a></li>
+                  <li><a href="{{ base_url }}/topics/credits{{ suffix }}">Credits</a></li>
                 </ul>
               </li>
             </ul>