[drupal-docs] Where do I start
puregin
puregin at puregin.org
Thu Apr 28 20:52:07 UTC 2005
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
More information about the drupal-docs
mailing list