[drupal-docs] Handbook v2

[Stefan Nagtegaal]

Op 19-mrt-05 om 21:44 heeft Boris Mann het volgende geschreven:

> 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

Maybe, a little offtopic, but how are we gonna notice the differences 
between multiple versions of a page?
I thought Gordon Heydon did made a module once, where the aaded texts 
were noticed between <strong>-tags and removed text between 
<strike>-tags..

Is this already discussed before, or am I having a valid point here?



Stefan