[drupal-docs] Handbook 2

[Anisa]

Boris Mann wrote:

>>I too have problems with the separation of 'admin guide' and 'user
>>guide'.  Isn't the 'admin' our 'user'?
>>    
>>
>
>We need to define it then. My definition for admin:
>* may or may not have installed Drupal (so no install instructions here)
>* has #1 admin user privileges
>* does setup/config through Drupal interface
>
>For user:
>* has an account on a Drupal site
>* wants to know how to use features, create content
>
>  
>
I know you like this idea, but I still don't understand why.  Why does 
the end user need documentation on Drupal.org?  If you're going to have 
it, shouldn't this be stuff bundled with Drupal in the help texts?

>>I think we should aim for a book to be at most 3 or 4 levels deep.
>>    
>>
>
>Agreed. Which means we need a flatter set of top-level pages.
>
>  
>
Hm.  Well, I don't think Events is relevant to what the 'Handbook' is 
about, and certainly, it's not linked as a top level page in the current 
handbook. 

What about taking out the About Drupal and turning that into a tab on 
the top (before 'Support')?

I still get the sense that we're not really improving the layout here...

What about...
Getting started...  Requirements.  Installation.  Troubleshooting common 
problems.
Configuring your drupal site.  Most everything in the Admin guide.
Customizing drupal .  Anything involving hacking at the code.
Contributing. Put working groups under here.  Instructions on cvs, etc.

I'm not super attached to this, but I do think if we're going to go 
through the effort of all this, we should re-think the organization a 
little.  Once you make it, it's hard to go back.

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