[drupal-docs] Handbook Root books

bryan kennedy digital at mysteryexperience.com
Thu Apr 28 19:40:33 UTC 2005


On Apr 27, 2005, at 10:55 PM, Anisa wrote:

> I don't think the handbook titles should be soo long, and, in general,
> the word Drupal, except for the About Drupal section, is probably
> unnecessary.

Could you make some specific suggestions?  I know we said we shouldn't 
use Drupal unnecessarily in the headings but if we go with this style 
of book titles it's hard to pull out.  My motivation was to make the 
title's about the content within rather than the person who might use 
it.  Breaking the handbook by user type is a false dichotomy.  Very few 
of us are just one of these roles.  We might go to the section about 
administer a drupal site but we aren't just admins.  This type of 
information architecture is confusing and what we trying to move away 
from in the current handbook.  It forces people to identify what they 
are, when we really need them to answer "what do you want to do".  We 
should really try to make the documentation "task based".

So yeah I think the books we need to create are still:
-Getting Started and Using a Drupal Website (this needs a better name)
-Administering a Drupal Website (be hard to pull drupal out of this)
-Developing for Drupal (would "Developing" work?)
-About Drupal
-About the Handbook

thanks
bryan




More information about the drupal-docs mailing list