[drupal-docs] Moving handbook to docs.drupal.org

[Anisa]

Why are comments allowed on handbook pages?  Comments are rather messy. 

As for letting people interested in maintaining documentation know what 
to do, a little something on the bottom of all the handbook pages would 
do.  Maybe join the docs list or something.  Maybe set up a report 
errors email.

Would a wiki be better?  A controlled one, where only certain people can 
edit it.

Anisa.

Dries Buytaert wrote:

>
> OK, it appears there are a number of issues here.  To summarize:
>
> 1. The documentation sucks: people don't find the information they need.
> 2. The process to maintain documentation sucks: documentation writers 
> don't know what is going on.
> 3. Poor separation between user and developer community.
>
> We want to tackle (1) by reorganizing the handbook from scratch.  We 
> need to tackle (2) by improving Drupal itself, and the book module in 
> particular (or by using CVS). There are different ways we can tackle (3).
>
>> Here's an alternative that MIGHT work: give us a new root book -- 
>> call it handbook v2. The doc team can decide how best to organize 
>> this, and migrate external and local pages into it. It's still 
>> starting from scratch, but it retains node IDs.
>
>
> That works for me.  We'd still need to deal with 2 and 3 separately 
> though.
>
> -- 
> Dries Buytaert  ::  http://www.buytaert.net/
>