[documentation] Contributions needed to core documentation

[Dmitri Gaskin]

That would be optimal, but we need new documentation for Drupal 7.
What people put in to there will not be filling up the handbooks, it  
will be transfered into the new help system included in drupal core.  
It will be come the help pages.
We need *some* help to be included in core, because there is no  
guarentee that it will come in later.

So if we can at least get a large start, not all of it needs to be  
finished, but a lot of it.

Dmitri

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

> Module maintainers should start writing docs in the new context,
> anyone who just figured out something, document team members can write
> overviews like the theming handbook...
>
> That way, it can be written gradually, not in one heroic go.
>
>
>
> On Sun, Dec 7, 2008 at 3:10 PM, Victor Kane <victorkane at gmail.com>  
> 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/