[documentation] The handbook organization

[Steven Peck]

People keep saying it's important but they never propose anything
concrete much less contribute what they think would be neat.  Just talk
about it in general terms.  And say what it should be some more this or
that, then talk some more, then wander off.

If the Marketing Team doesn't do it, then at some point, I will and then
take all the abuse again.  But it will be different and done.  

Of course, it's been mentioned that some feel system requirements belong
there.

Version number and whick you should use is sort of important but propose
somewhere to move it.  Stuff used on Drupal.org.... These two have cut
down on an enormous load of questions in the forums.

Maybe if someone who is interested put together an outline?  Tossed some
intial suggested content?  I have a scratch site that I can grant access
to for people to edit and collaborate on.  The one part that needs to be
there is the history (http://drupal.org/node/10257) because it is an
import part of what Drupal is and where Drupal came from.  This is Open
Source, free and people need to know that whether they want to or not.
That mission helps determine what support and what direction things are
likely to go in.  

If need be some of the other stuff can be broken out into a different
section or moved entirely.  

I'm getting sort of selfish with my time as my interests grow and things
I want to play with in Drupal draw my attention.  I'd like other folks
to take up an area responsibilty for proposing something, gathering
feedback and refining it and then coordinating the doing of it.

-sp

> -----Original Message-----
> From: documentation-bounces at drupal.org 
> [mailto:documentation-bounces at drupal.org] On Behalf Of Gary Feldman
> Sent: Friday, September 01, 2006 8:27 AM
> To: A list for documentation writers
> Subject: Re: [documentation] The handbook organization
> 
> Steven Peck wrote:
> > The About Drupal section.... The Marketing Team was supposed to be
> > working on this which is why other then a very basic pass at it it
> > hasn't been touched.  There was talk about strategy, 
> vision, consultant
> > guides, etc... But virtually no work other then Kieren adding some
> >   
> If I might make a radical proposal, the About Drupal section is an 
> important web site page, but doesn't belong in the same 
> grouping as the 
> other handbooks.  It's kind of like getting a new, 
> complicated digital 
> camera and discovering that the first fifty pages of the manual are 
> talking about the history of the manufacturer, predecessor 
> versions of 
> the camera, whether or not you should have bought the camera in the 
> first place, etc.
> 
> Perhaps the recent work for changing the way books are 
> organized could 
> be used to treat this entire handbook as something different from the 
> others, which really are About Using Drupal.
> 
> Gary
> 
> 
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
> 
>