Merge branch 'master' of http://git.gitorious.org/mediagoblin/mediagoblin

2 files changed, 76 insertions, 7 deletions

diff --git a/docs/hackinghowto.rst b/docs/hackinghowto.rst
index fdb53a25..40d14e24 100644
--- a/docs/hackinghowto.rst
+++ b/docs/hackinghowto.rst
@@ -49,9 +49,22 @@ requirements::
     sudo apt-get install mongodb git-core python python-dev \
          python-lxml
 
+After getting the requirements, there are two ways to build a development environment:
+
+1. Running bootstrap and buildout, OR
+2. Creating a virtual environment
+
+Pick one---don't do both!
+
+
+Creating a dev environment with bootstrap and buildout
+------------------------------------------------------
+
+.. Note::
+
+   Either follow the instructions in this section OR follow the ones
+   in the next one---don't do both!
 
-Running bootstrap and buildout
-------------------------------
 
 After installing the requirements, follow these steps:
 
@@ -79,10 +92,6 @@ purposes this default should be fine.
    <http://pypi.python.org/pypi/virtualenv>`_, that should work just
    fine.
 
-
-Updating dependencies
----------------------
-
 While hacking on GNU MediaGoblin over time, you'll eventually have to
 update your development environment because the dependencies have
 changed.  To do that, run::
@@ -95,6 +104,66 @@ changed.  To do that, run::
     need to do this when you've made code changes.
 
 
+Creating a dev environment with virtualenv
+------------------------------------------
+
+.. Note::
+
+   Either follow the instructions in this section OR follow the ones
+   in the previous one---don't do both!
+
+The following assumes you have these things installed:
+
+1. virtualenv:
+
+   http://pypi.python.org/pypi/virtualenv
+
+2. virtualenv wrapper:
+
+   http://www.doughellmann.com/projects/virtualenvwrapper/
+
+3. git:
+
+   http://git-scm.com/
+
+
+Follow these steps:
+
+1. Clone the repository::
+
+       git clone http://git.gitorious.org/mediagoblin/mediagoblin.git
+
+2. Create a virtual environment::
+
+       mkvirtualenv --no-site-packages mediagoblin
+
+3. If that doesn't put you in the virutal environment you just created, then do::
+
+       workon mediagoblin
+
+4. Run::
+
+       python setup.py develop
+
+
+That's it!
+
+When you want to work on GNU MediaGoblin, you need to activate the
+virtual environment like this::
+
+    workon mediagoblin
+
+If you want to deactivate it, you can do this::
+
+    deactivate
+
+.. Note::
+
+   You don't have to do anything additional to move changes you're
+   making to your virtual environment because the virtual environment
+   is pointing at the actual code files.
+
+
 Running the server
 ==================
 
diff --git a/docs/mediagoblin.rst b/docs/mediagoblin.rst
index 6d511850..df2190c1 100644
--- a/docs/mediagoblin.rst
+++ b/docs/mediagoblin.rst
@@ -60,7 +60,7 @@ Is this an official GNU Project?  What does that mean?
 
 We are!  It means that we meet the GNU Project's rigourous standards
 for free software.  To find out more about what that means, check out
-`the GNU site <http://gnu.org/>`.
+`the GNU site <http://gnu.org/>`_.
 
 Please feel free to contact us with further questions!