[drupal-docs] Handbook v2

[Ron Mahon]

Why not use the forum to have the discussions on any changes to the books
instead of the comments. 

That way you still get the interaction of all types of people expert and
novice. Just a simple link to the forum maybe "Discuss this Page".

Preserves the best of both worlds and doesn't isolate any one.
Ron

InterNet Marketing Resource Center
A Free Super Mart of Articles, Demos, Tutorials everything you need to
Succeed on the net.
www.inmrc.com 


-----Original Message-----
From: Boris Mann [mailto:borismann at gmail.com] 
Sent: Saturday, March 19, 2005 3:44 PM
To: drupal-docs at drupal.org
Subject: [drupal-docs] Handbook v2

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