[documentation] Proposal for a "Contributing to Drupal" handbook section

Addison Berry drupal at rocktreesky.com
Sat Mar 15 18:24:25 UTC 2008


OK, so I spent some time fleshing out an outline based off our sprint  
discussion. Note that this is very preliminary and much will still  
need to be jostled about, including continuing to find the right  
titles for things. I'm hoping this spurs another round of feedback and  
interest from the list. I'd like to edit this up and then schedule an  
IRC "meeting" where hopefully at least some of us can get together and  
bounce ideas/refine real-time.

Next weekend is a bad weekend for many (holidays and all) but I also  
don't want this to sit for very much longer. So does  Wednesday or  
Thursday next week (March 19,20) work for folks or would you prefer to  
wait until the weekend of March 29-30?

Things to keep in mind:

1) This will be a section under a drupal.org-specific handbook that  
will have other stuff top-level (I suspect things like drupal.org FAQ,  
About documentation, Site maintenance yadda yadda)
2) We will be moving a fair bit of stuff to this new Contributing to  
Drupal section, not replicating and/or pointing off. The idea is to  
make this the "source" section and other areas of the handbook can  
refer to it. That means some of this is new handbook content and a lot  
of it will be moving and reworking existing content.
3) I like Senpai's idea for having a brief intro with more details  
below in terms of content. I'd like to get an outline for this mostly  
settled (we can always keep tweaking it but I don't want to start it  
and redo it completely every week) and then work out the structure for  
the pages.

CONTRIBUTING TO DRUPAL
=======================
Get a drupal.org account
Talk with the Community
How to effect change/join forces
Issue queue
Forums
IRC
Mailing lists
external sites (g.d.o, dojo)
Drupal's work space: the Issue Queue
Guidelines
Searching
Report a problem
Give feedback
Documentation
Adding new pages
Editing and deleting pages
Docs issue queue
Join the docs team
Translating (this procedure will change to not require CVS anymore)
Testing
What code to test
Applying patches
How to test and report findings
Contributing code
Help existing code: Patching bugs and features
Finding issues to work on
Creating patches
Submitting patches
Maintain a Project: Modules, Themes and Installation Profiles
Getting a CVS account
Sandbox policy
Starting a new project
Things to consider
Add code to CVS: Step-by-step
pages for each client (CLI, Tortoise, CVSGUI, Eclipse, etc.)
Create the project on drupal.org
Project node
Handbook page
Maintaining a project
How to be a good maintainer
Managing releases
Releases, branches and tags, oh my!
Using your HEAD
Working with Update Status
Step-by-Step
section for tasks (new version of your module, new release, etc.)
Troubleshooting release problems
What is CVS and how Drupal uses it
Introduction to CVS/RCS
CVS Usage Policy/Guidelines
CVS GUIs and clients
Drupal repositories
Drupal branches and tags
Quick reference sheet
CVS/Project FAQ

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.drupal.org/pipermail/documentation/attachments/20080315/97e9c35b/attachment.htm 


More information about the documentation mailing list