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

[Steven Peck]

> -----Original Message-----
> [mailto:drupal-docs-bounces at drupal.org] On Behalf Of Anisa
> 
> Why are comments allowed on handbook pages?  Comments are 
> rather messy. 

Technically they are there to point out additions or errors to the page
in question.  Theoritically any updates need to get moved into the
handbook page and/or deleted.  A lot of them have.  Time and people.
Site Maintainers were added in December 2004.

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

I personally am not a big fan of wiki's except for prototyping, but
that's just me.  I would rather use Drupal's built in book function.
This show's confidence in the project and perhaps will shine a light on
areas that could be extended.
 
> 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.
> >
> >> 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/
> >
I like it [solution to item 1].  

This means lots of structure planning first then and some serious rules
spelled out to avoid getting back into the situation the documentation
currently is in.  Work/time constraints has prevented me from exploring
all the links posted often, but has anyone put out an example document
structure that people can look at and discuss? [addressing item 2]

[item 3] This seperation is blurry.  I'm going to go look at the wiki
and see what I missed this week 

This is so cool.

-sp