From 75b70b90c3235d9883a799c4aea659879b5b3d89 Mon Sep 17 00:00:00 2001 From: Will Kahn-Greene Date: Sun, 24 Apr 2011 21:29:50 -0400 Subject: Fixes mdashes and other minor things. --- docs/contributinghowto.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/contributinghowto.rst') diff --git a/docs/contributinghowto.rst b/docs/contributinghowto.rst index a44c361f..cb5cd909 100644 --- a/docs/contributinghowto.rst +++ b/docs/contributinghowto.rst @@ -64,7 +64,7 @@ help with. 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! + great---you can run your own instance! For more information on deploying your own instance, see :ref:`deployment-howto`. -- cgit v1.2.3 From 9d952fdc7930dcdf1c2ee5ca6094c80a998d86ba Mon Sep 17 00:00:00 2001 From: Will Kahn-Greene Date: Wed, 27 Apr 2011 22:42:17 -0400 Subject: Reworked contributing docs based on Asheesh's thoughts I chatted with Asheesh on IRC today and asked him to look over the contributer howto. He had a lot of thoughts and I factored most/all of them in. It's much better now. --- docs/contributinghowto.rst | 115 ++++++++++++++++++++++++++++----------------- 1 file changed, 73 insertions(+), 42 deletions(-) (limited to 'docs/contributinghowto.rst') diff --git a/docs/contributinghowto.rst b/docs/contributinghowto.rst index cb5cd909..3b3fe163 100644 --- a/docs/contributinghowto.rst +++ b/docs/contributinghowto.rst @@ -2,72 +2,104 @@ Contributing HOWTO ==================== -We're super glad you want to contribute! +Join the community! +=================== + +We're super glad you want to join our community! There are a variety of ways you can help us and become part of the team. We're not just looking for coders! We're also looking for -documentation writers, users, testers, evangelists, painters, bakers, -candle-stick makers... +documentation writers, users, testers, evangelists, user-interface +designers, graphics designers, user-experience designers, system +administrators, friends, painters, bakers, candle-stick makers... -However, if you are a coder and you're looking to code, check out the -:ref:`hacking-howto`. +Here are some things you can do today: -The rest of this chapter talks about different things we need your -help with. + **Hang out with us** -**Become a user** + You should hang out with us! We like people like you! - 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. + At a bare minimum, join the `mailing list + `_ and say, "Hi!" + We also hang out on IRC in ``#mediagoblin`` on Freenode.net. -**File bugs** - Filing bugs is a critical part of any project. For more - information on filing bugs, see :ref:`filing-bugs`. + **File bugs** + Filing bugs is a critical part of any project. For more + information on filing bugs, see :ref:`filing-bugs`. -**Translate GNU MediaGoblin** - Knowing more than one language is an important skill. If you are - multi-lingual and are interested in translating GNU MediaGoblin, - see :ref:`translating`. + **Write/Fix some code** + If you are a coder and you're looking to code, check out the + :ref:`hacking-howto`. We even have tips on *becoming* a coder + and we're willing to help you! -**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`. + **Run your own instance** + + Are there things about our instance you want to change? Are + there things about other instances you wish were different? + Want to test upcoming changes? Want to create patches to + implement things you need? That's great---you can run your + own instance! + + For more information on deploying your own instance, see + :ref:`deployment-howto`. -**Spread the word** + **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! + 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 - do we want to talk about ways to spread the word? - FIXME - how can people notify us that they're spreading the word? + FIXME - how can people notify us that they're spreading the + word? -**Run your own instance** +We're still working on project infrastructure. We hope to have the +bits in place for these additional things to do in the coming months: - 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! + **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. - For more information on deploying your own instance, see - :ref:`deployment-howto`. + 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. + + + **Help other users** + + Have you spent time with GNU MediaGoblin? If so, your + experience and wisdom are invaluable and you're the best + person we can think of to help other users with their + questions. + + + **Translate GNU MediaGoblin** + + Knowing more than one language is an important skill. If you + are multi-lingual and are interested in translating GNU + MediaGoblin, see :ref:`translating`. + + + **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`. Contributing thank you drawings / copyright assignment @@ -93,8 +125,7 @@ File bugs GNU MediaGoblin uses a bug tracker called `Redmine `_. -The bug tracker is at http://bugs.foocorp.net/ and bugs go in the -``GNU mediagoblin`` project. +The bug tracker is at ``_. A good bug report has the following things in it: -- cgit v1.2.3 From 0c953025122fbbf0fd9d6c52f490802bca3648c0 Mon Sep 17 00:00:00 2001 From: Will Kahn-Greene Date: Thu, 28 Apr 2011 10:38:37 -0400 Subject: Moves "run your own instance" to the future section Chris correctly pointed out that you can't quite run your own instance, yet. But that's the goal! --- docs/contributinghowto.rst | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) (limited to 'docs/contributinghowto.rst') diff --git a/docs/contributinghowto.rst b/docs/contributinghowto.rst index 3b3fe163..ff783b9c 100644 --- a/docs/contributinghowto.rst +++ b/docs/contributinghowto.rst @@ -39,18 +39,6 @@ Here are some things you can do today: and we're willing to help you! - **Run your own instance** - - Are there things about our instance you want to change? Are - there things about other instances you wish were different? - Want to test upcoming changes? Want to create patches to - implement things you need? That's great---you can run your - own instance! - - For more information on deploying your own instance, see - :ref:`deployment-howto`. - - **Spread the word** The seductive call of Free Software services is a powerful @@ -88,6 +76,18 @@ bits in place for these additional things to do in the coming months: questions. + **Run your own instance** + + Are there things about our instance you want to change? Are + there things about other instances you wish were different? + Want to test upcoming changes? Want to create patches to + implement things you need? That's great---you can run your + own instance! + + For more information on deploying your own instance, see + :ref:`deployment-howto`. + + **Translate GNU MediaGoblin** Knowing more than one language is an important skill. If you -- cgit v1.2.3 From 4305e7e64bdf0889f96199a4b6219911fcb08b82 Mon Sep 17 00:00:00 2001 From: Will Kahn-Greene Date: Thu, 28 Apr 2011 10:58:16 -0400 Subject: Adds "Send encouragement" section --- docs/contributinghowto.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) (limited to 'docs/contributinghowto.rst') diff --git a/docs/contributinghowto.rst b/docs/contributinghowto.rst index ff783b9c..f10dd72a 100644 --- a/docs/contributinghowto.rst +++ b/docs/contributinghowto.rst @@ -39,6 +39,16 @@ Here are some things you can do today: and we're willing to help you! + **Send encouragement** + + A nice word from you could send someone into a tizzy of + productive work. Ten nice words could complete a feature. + One hundred nice words could get us to the next milestone. + + Send it to the `mailing list `_ + or hop into ``#mediagoblin`` on Freenode.net and let us know. + + **Spread the word** The seductive call of Free Software services is a powerful -- cgit v1.2.3