[documentation] Documentation session in Vancouver

[Kieran Lal]

We need to prioritize opening up the handbook for contributors.

I was just reading about the popularity of Digg vs. Slashdot.  Digg  
is collective ranking where as Slashdot is the personal preferences  
of a handful of editors.  http://jeremy.zawodny.com/blog/archives/ 
006081.html  It scared me that we are just falling behind by not  
getting this collaborative nature of contributions.

The documentation handbook is managed by a small subset of the site  
maintainers.  It's time to drink the cool-aid and open it up, or at  
the very least make good use of revisions :-)

Cheers,
Kieran


On Jan 11, 2006, at 7:09 PM, Angie Byron wrote:

> As some may or may not know, I'm planning to moderate a session  
> about Drupal documentation at the Open Source CMS Summit and  
> DrupalCon in Vancouver next month. I have some ideas of things I'd  
> like to open for discussion, but thought it good to canvas here too  
> for ideas (especially if you're planning to attend! remember that  
> these are working group discussions and not presentations (thank  
> goodness ;)).
>
> Some topics I am thinking about are:
>
> * What improvements can we make to the handbook?
> * How can we nake it easier for people to contribute?
> * What strategies can we utilize for distributing module  
> documentation centrally from Drupal.org?
> * How can we more efficiently store help documentation for modules  
> rather than placing text inside the files themselves?
>
> I welcome any feedback anyone would like to give. I want to make  
> sure we cover a broad range of topics and get a clear plan of  
> action as a result of this session. This is the first time I've  
> ever done something this so I can use all the help/advice I can  
> get, hehe. ;)
>
> -Angie
>
> P.S.
> For more information on OSCMS/DrupalCon, see:
> http://drupal.org/conference-vancouver-2006
>
> To sign up for the session, go to:
> http://scratch.blkmtn.org/index.php?q=node/37
>
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
>