[documentation] Contributions needed to core documentation

[Dmitri Gaskin]

Describe please. Sorry for sending the email multiple times.

Dmitri

On Dec 7, 2008, at 9:10 AM, Victor Kane wrote:

> No!
>
> Documentation should be crowd-sourced, on the heels of the excellent
> opening up of the editing of the document handbooks.
>
> It shouldn't require "extra work", but rather, a climate favorable to
> crowd participation should be created.
>
> Victor Kane
> http://awebfactory.com.ar
>
> On Sun, Dec 7, 2008 at 3:08 PM, Dmitri Gaskin <dmitrig01 at gmail.com>  
> wrote:
>> Drupal 7 will (hopefully) see the introduction of a new and  
>> completely
>> overhauled help system (read: starting from scratch).
>> However, this means that all documentation must be re-written.
>> This is not a job for one person! We need everyone to pitch in and  
>> help (no
>> pun intended). If everyone can write two (2) pages, then we'll be
>> <strong>very</strong> well off.
>> The kind people at the Help System group on groups.drupal.org
>> (http://groups.drupal.org/help-system) have assembled a workflow  
>> for you to
>> take part in. Here's how to write a help page for a module:
>> 1. Log in <a href="http://groups.drupal.org/user/login">here</a>.  
>> If you
>> don't already have an account, you can log in
>> with YOUR_DRUPAL.ORG_USERNAME at drupal.org as your usename and your  
>> drupal.org
>> password as your password.
>> 2. Navigate your browser
>> to http://groups.drupal.org/node/add/wikipage?gids[]=12401 to start  
>> your new
>> wiki page.
>> 3. Choose "Drupal Documentation Task" for the "Group categories"  
>> vocabulary
>> 4. Choose the name of the module for which you are writing  
>> documentation for
>> the "Help topic module" vocabulary
>> 5. Fill in the title and the body to those that you wish to appear  
>> on your
>> help page.
>> 6. Be sure to adhere to the guidelines
>> ("http://groups.drupal.org/node/17302").
>> 7. Hit submit!
>> If everyone can do two (2) of these, we'll have all the help pages  
>> in core
>> done in a matter of days. And guess who it starts with? You!
>> If you would like to edit an existing page, simply go to the Help  
>> System
>> group (http://groups.drupal.org/help-system) find the page along  
>> the left,
>> click on it, and click the edit tab.
>> Things to note:
>> 1. The topic titles of each module, on the left side of group page,  
>> are not
>> listed in any order (although the modules are). The final order can  
>> be
>> decided later.
>> 2. We are not using the drupal.org handbooks for specific styles/ 
>> patterns
>> that we need to follow for the help module's requirements. Check  
>> comments
>> at http://groups.drupal.org/node/17287 for further information.
>> --
>> Pending work: http://drupal.org/project/issues/documentation/
>> List archives: http://lists.drupal.org/pipermail/documentation/
>>
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/