Updates contributing howto

* lots of changes to the contributing howto from Matt, Greg, Will, and
  Chris
* adds references between the contributing howto and other chapters
* adds a design decision regarding copyright assignment

1 files changed, 81 insertions, 6 deletions

diff --git a/docs/contributinghowto.rst b/docs/contributinghowto.rst
index 1b34badc..a44c361f 100644
--- a/docs/contributinghowto.rst
+++ b/docs/contributinghowto.rst
@@ -15,9 +15,21 @@ However, if you are a coder and you're looking to code, check out the
 The rest of this chapter talks about different things we need your
 help with.
 
+
+**Become a user**
+
+    We're building GNU MediaGoblin for us and for you but really
+    you're one of us and I am you and we are we and GNU MediaGoblin is
+    the walrus.
+    
+    Sign up for an account.  Use the service.  Relish in the thought
+    that this service comes with a heaping side of Freedom and you can
+    salt and pepper it to your liking.
+
+
 **File bugs**
 
-    Filing bugs is an important part of any project.  For more
+    Filing bugs is a critical part of any project.  For more
     information on filing bugs, see :ref:`filing-bugs`.
 
 
@@ -27,7 +39,50 @@ help with.
     multi-lingual and are interested in translating GNU MediaGoblin,
     see :ref:`translating`.
 
-FIXME - add additional things here
+
+**Create a theme**
+
+    As people deploy their own GNU MediaGoblin instances, good themes
+    are a must have!  For more information on theming, see
+    :ref:`theming-howto`.
+
+
+**Spread the word**
+
+    The seductive call of Free Software services is a powerful one,
+    but many cannot hear it because it'd drowned out by the rush hour
+    traffic honking of proprietary walled gardens and faux free
+    services.  Yuck!  Be the sweet chirrup of the bird amidst the din!
+    Tell others that there is a better way to live!
+
+    FIXME - do we want to talk about ways to spread the word?
+
+    FIXME - how can people notify us that they're spreading the word?
+
+
+**Run your own instance**
+
+    Are there things about our instance you want to change?  Are there
+    things about other instances you wish were different?  That's
+    great--you can run your own instance!
+    
+    For more information on deploying your own instance, see
+    :ref:`deployment-howto`.
+
+
+Contributing thank you drawings / copyright assignment
+======================================================
+
+Copyright assignment with GNU MediaGoblin to the `FSF
+<http://fsf.org>`_ is highly encouraged but not mandatory.  To
+incentivize both this and people to make cool contributions to our
+project, if you make useful contributions to GNU MediaGoblin *and* do
+a copyright assignment to the Free Software Foundation, the founder of
+the project, Chris Webber, will make a custom drawing of a goblin
+dedicated specifically to you.
+
+For why we're doing copyright assignment, see the
+:ref:`design-decisions-chapter`.
 
 
 .. _filing-bugs:
@@ -36,12 +91,30 @@ File bugs
 =========
 
 GNU MediaGoblin uses a bug tracker called `Redmine
-<http://www.redmine.org>`.
+<http://www.redmine.org>`_.
 
 The bug tracker is at http://bugs.foocorp.net/ and bugs go in the
 ``GNU mediagoblin`` project.
 
-FIXME - how to file a good bug report
+A good bug report has the following things in it:
+
+1. A short summary that's 60 characters or less.
+
+2. A description that describes the issue (bug, feature request, ...)
+   as well as the context.
+
+  * If it's a bug, can you reproduce it?  Is the issue specific to a
+    browser, computer, image, ...?
+
+  * If it's a feature request, are there related links on the Internet
+    for more information?  Would you be willing to help implement or
+    test the feature?
+
+That's it!  When someone looks into the issue and has questions,
+they'll contact you!
+
+If you don't hear from anyone in a couple of weeks, find someone on
+IRC.
 
 
 .. _translating:
@@ -49,10 +122,12 @@ FIXME - how to file a good bug report
 Translate GNU MediaGoblin
 =========================
 
-FIXME - need to write this
+Coming soon when we set up translation infrastructure.
 
 
 Where to go when you get stuck
 ==============================
 
-FIXME - need to write this
+Go to `our Web site <http://mediagoblin.org/>`_ where we list the
+various places we hang out and how to get a hold of us.
+