[drupal-docs] Handbook v2

[Boris Mann]

OK, after I made enough of stink, we got to  a consensus, sort of. 
Comments are another issue which we can't solve right away, but which 
we can police a lot more effectively as we build up new pages.

I've written up extensive thoughts here: 
http://dev.bryght.com/t/wiki/HandbookVersionTwo

It includes book technology suggestions. Please add/edit comments there.

On 18-Mar-05, at 12:11 PM, 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).

I actually don't see (3) as too much of an issue. Or rather, that we 
can serve both communities by my suggested hierarchies, and perhaps 
some guidance on the front page of Drupal that points different user 
groups to appropriate channels/an intro page.

>> 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.

--
Boris Mann
http://www.bryght.com