[drupal-docs] Round 4 of documentation sprint Admin help: merging into the handbook

Kieran Lal kieran at civicspacelabs.org
Tue May 24 13:58:05 UTC 2005


On May 23, 2005, at 9:12 PM, Kieran Lal wrote:

I'll try to address Charlie's, Djun's, Dries's, and Anisa's comments  
here.

> Hi, I am beginning round 4 of the Drupal admin help documentation  
> sprint.   I figured it would take at least 5 revisions to make it  
> work, so we are getting close to the end.
>
> Here's the plan:
> 1) Change the handbook links for Drupal core to point to the  
> existing relevant handbook pages.
> 2) Change the titles of the  Drupal handbook » Administrator's  
> guide » Drupal modules and features to start with the module name:  
> a brief phrase.

Charlie, titles can begin with capital letters on the module name.

Djun, this section is not well organized.   By adding the module name  
to the title the Drupal core module pages will be organized  
alphabetically and therefore make for better searching.   A card sort  
is a good idea.  In the meantime we are settling on two top level  
categories, core modules and contributed modules.  I believe the  
intention is to phase the existing administration handbook into the  
configuration and customization handbook by renaming the book and by  
re-organizing pages.

> 3) Move the configuration and customization handbook contributed  
> modules section: http://drupal.org/handbook/config/contribmodules  
> to the existing handbook http://drupal.org/node/279 (Djun)

Anisa, since we are no longer doing handbook version 2 we are moving  
the pages already created for contributed modules into the existing  
handbook, rather than create new pages.  There do not appear to be  
any new handbook pages for contributed modules.

> 4) Move sprint admin help text to the top of the existing handbook  
> pages.

Djun, there are handbook pages for each of the modules in Drupal  
core.  Sometimes more than one.  We are basically just going to add  
the admin help text to the top of those existing pages, so there's  
not need for parallel new and old pages.  As Dries, indicated there  
is always revisions if necessary.

> 5) Move the old admin help that exists to a sub page of the  
> handbook module page.

Dries, the current admin event help text is 481 words long.  The new  
admin help text is 192 words long.  The risk is that if we don't  
create a sub page with the existing admin help we may lose a lot of  
valuable information.  The editing of the handbook pages content is  
still a large job and Charlie, Anisa, and I have to agree what the  
contents of a handbook module page should be.

> 6) Review the admin help text for readability.
> 7) Coordinate new handbook module writing instructions with Anisa  
> and Charlie.
> 8) If possible, change the relative links in the handbook, to bread  
> crumbs format.  page >> page >> page.

9) Do a link search for all the existing module handbook pages.  As  
the pages are renamed we are going to need go through the handbook  
and discover if renaming the handbook pages has an adverse effect  
existing handbook text.

For example search for pages that point to the blog module handbook  
page: http://www.google.com/search?&rls=en&q=link:http://drupal.org/ 
node/280.  Make sure the links still make sense when the page they  
are pointing to is renamed.  Users who are new to a topic can get  
confused if they link they click on is named differently than the  
title of the page.

>
> As always, help is needed.

Thanks for your comments.

>
> Cheers,
> 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/20050524/a9949aad/attachment.htm


More information about the drupal-docs mailing list