[drupal-docs] Admin help longs to be read by skilled Drupal user

[Kieran Lal]

On May 28, 2005, at 7:13 AM, Anisa wrote:

> Some of it is a little techy...  Is that OK?  (ex. RSS, OPML in  
> aggregator).

No it's not OK to be too technical.  There is a place to be too  
technical and I suggest that it's the handbook, module sub pages.   
Admin help, and the first page of the module documentation should be  
comprehensible by new users.

Could you tell me which modules are too technical and I'll take a  
look at rewriting them.  Of course if you have the time just go ahead  
and change them yourself.  We do have revisions available :-)

Thanks,
Kieran
>
> I long to delete some of these old comments...
>
> Anisa.
>
> Kieran Lal wrote:
>> Howdy, 203 of you completed the Drupal documentation survey and told
>> us that the number one thing you wanted was module documentation.
>>
>> The goal of this admin help documentation is:
>> 1) Provide documentation for Drupal modules.
>> 2) Improve the usability of the admin help.
>> 3) Improve the documentation teams ability to work with admin help by
>> single sourcing it from the documentation handbook.
>>
>> Here is the documentation for Drupal core:http://drupal.org/handbook/
>> modules
>> Here is the documentation for some of Drupal contributions: http://
>> drupal.org/handbook/modules/contributions
>>
>> The handbook module pages start with executive summaries that are
>> also admin help.  Pretty clever, don't you think.  The handbooks are
>> currently under development, stay tuned for more improvements.  It
>> would be greatly appreciated if knowledgeable Drupal users could read
>> some of them and report back on where they are wrong.
>>
>> If you need a site to confirm this documentation, create an account
>> on: http://demo.civicspacelabs.org/home and send me a link to your
>> profile.  I'll make sure you get the access you need to confirm the
>> documentation is accurate.
>>
>> Thanks for you help,
>> Kieran
>>
>>
> -- 
> [ drupal-docs | http://lists.drupal.org/listinfo/drupal-docs ]
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://drupal3.drupal.org/pipermail/documentation/attachments/20050529/d04b1afb/attachment.htm