[drupal-docs] Where do I start

[Ron Mahon]

A doc outline form would make it possible for the reluctant author to
inprove there documentation and free the others from a dreaded task. Either
way both would benefit from the experience.
The drupal end users would take a giant step forward
Ron 


InterNet Marketing Resource Center
A Free Super Mart of Articles, Demos, Tutorials everything you need to
Succeed on the net.
www.inmrc.com 


-----Original Message-----
From: puregin [mailto:puregin at puregin.org] 
Sent: Thursday, April 28, 2005 4:51 PM
To: drupal-docs at drupal.org
Subject: Re: [drupal-docs] Where do I start


On 28 Apr 2005, at 12:56 PM, Kieran Lal wrote:

>
> On Apr 28, 2005, at 9:44 AM, Boris Mann wrote:
>
>> Um, no. If I were the owner of a contrib module, I wouldn't want it 
>> rewritten by someone else.
>
> In the documentation survey the single most consistent result was that
> 75% of respondents wanted application (module) documentation.   The
> theme of needed module documentation was consistent throughout the 
> survey.  It's clear to me that module developers can't, won't, haven't 
> met the documentation needs of users.
>
> I think we have to move past the idea the developers have the time, 
> willingness, or resources to do this job.  With all due respect to the 
> module writers, if someone wants to write module documentation, I say 
> let them.
>

     I'm with Kieran on this one.   At least a couple of the contributed 
modules' authors
seem to have explicitly asked for assistance with documentation and
help texts.    It also seems to me that contributing documentation or
improving help texts doesn't really alter the nature of a particular module,
except perhaps to make it easier for the user to understand what's going on.

      Djun