[documentation] The handbook organization

Sat Sep 2 01:39:06 UTC 2006

Oh also
http://drupal.org/node/24049

Any effort needs someone to coordinate and lead it.  I'd rather not lead
and coordinate the marketing stuff.  Others wanted to.  I will do it if
no one else does.  The last makor handbook re-org happened because the
previous incarnation needed help.  

The end result is that the handbook is in fact far more usable then it
was.  It can improve.  I'm all for that.  But people need to propse
concrete solutions not 'we should do' or if only we had'

So far the only real suggestions for the handbook are adding 'new
content' and 'recently updated content' blocks which is an excellent
idea.  We actually have the recently edited already in the handbook
updates page, just need to decide on display.

-sp

> -----Original Message-----
> From: documentation-bounces at drupal.org 
> [mailto:documentation-bounces at drupal.org] On Behalf Of Steven Peck
> Sent: Friday, September 01, 2006 6:34 PM
> To: info at urbits.com; A list for documentation writers
> Subject: RE: [documentation] The handbook organization
> 
> http://drupal.org/node/23743 
> 
> > -----Original Message-----
> > From: documentation-bounces at drupal.org 
> > [mailto:documentation-bounces at drupal.org] On Behalf Of sime
> > Sent: Friday, September 01, 2006 6:32 PM
> > To: A list for documentation writers
> > Subject: Re: [documentation] The handbook organization
> > 
> > Hi Steven
> > 
> > Just a question. May I ask who the marketing team are? 
> Seems a weird 
> > concept for the Drupal community. We don't have a 
> "development team", 
> > for example - we're all the team!
> > 
> > Simon
> > 
> > 
> > Steven Peck wrote:
> > 
> > >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/
> > >>
> > >>
> > >>    
> > >>
> > >--
> > >Pending work: http://drupal.org/project/issues/documentation/
> > >List archives: http://lists.drupal.org/pipermail/documentation/
> > >
> > >
> > >
> > >  
> > >
> > --
> > Pending work: http://drupal.org/project/issues/documentation/
> > List archives: http://lists.drupal.org/pipermail/documentation/
> > 
> > 
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
> 
> 