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
This commit is contained in:
Will Kahn-Greene 2011-04-22 22:02:55 -04:00
parent fad67707e1
commit 6a338d8e0e
5 changed files with 102 additions and 7 deletions

View File

@ -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.

View File

@ -1,3 +1,5 @@
.. _deployment-howto:
==================
Deployment HOWTO
==================

View File

@ -237,3 +237,19 @@ everyone is the hero by Will on "Why AGPLv3 and CC0":
.. _AGPL v3: http://www.gnu.org/licenses/agpl.html
.. _CC0 v1: http://creativecommons.org/publicdomain/zero/1.0/
Why copyright assignment?
=========================
Will Kahn-Greene on "Why copyright assignment?":
GNU MediaGoblin is a GNU project with the copyrights held by the
FSF. Like other GNU projects, we require copyright assignment to
the FSF which gives the FSF the legal ability to defend the
AGPL-covered status of the software and distribute it.
This is important to us because it guarantees that this software
we're working so hard on will be available to everyone and will
survive us. As long as someone is interested in using it and/or
working on it, it will live on.

View File

@ -13,8 +13,8 @@ Table of Contents:
foreward
mediagoblin
deploymenthowto
contributinghowto
deploymenthowto
hackinghowto
theminghowto
softwarestack

View File

@ -1,3 +1,5 @@
.. _theming-howto:
===============
Theming HOWTO
===============