[drupal-docs] Handbook 2

[Anisa]

So.

I am not entirely sure we are particularly better off than we were two 
weeks ago.  This is *not* a hard thing we're trying to make.

So.  You know...  Let's move it.  ^.^

Right now we need some real solid consensus on what the root books 
should be so that Dries or whomever can make them.  We need to decide on 
the site for developing the handbook.  Is that the Doc Books Wiki?  Is 
it the TWiki? (http://twiki.org/)  Someone needs to speak up and install 
test sites.  In, say, a week.

We also need to have a very serious discussion on style sheets. 

I cut out a long negative rant in this post but happy to bring it back 
if it will get things done faster or at least people motivated...  even 
if their motivation is to yell at me. ;)

Anisa.


Anisa wrote:

> 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/20050423/082fec57/attachment.htm