[drupal-docs] Handbook Root books

[Anisa]

Hm, well, I didn't give specific examples because I don't know that your 
version was all that different.  The problem is not so much getting 
people to go into the handbook, but to have them find what they need 
inside it.  So, for example, in the Admin Guide, having the first 
explain what it's about and what's in it vs what's in the other books 
would be more useful to me.

Certainly artificially assigning people user roles is not the best of 
things, but artificially determining what's needed for what task is also 
bound to lead to confusion.  To do it well you would have to make lots 
more little books, and that's more clicking than I would want to deal 
with, personally.

So I would go with the originally suggested versions, Admin Guide, 
Developer Guide, etc.  :)

Anisa.

bryan kennedy wrote:

>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
>
>  
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://drupal3.drupal.org/pipermail/documentation/attachments/20050429/3a47e3a0/attachment.htm