[documentation] Documentation session in Vancouver

[puregin]

Well, this should be a lively session!

On 11-Jan-2006, at 10:25 PM, Kieran Lal wrote:

> We need to prioritize opening up the handbook for contributors.

      This implies having the right structure.

      Parts of the documenation are very amenable to this
type of approach:  FAQs, best practices, how-to's,
hacks (snippets).

      Others are not.

      Completely opening up the
documentation  without some kind of
framework for control would be rather
like opening up Drupal CVS for
anonymous committers.

       I'm rather inclined to believe that
there are fewer good technical
writers in the house than good
programmers (though this may
be because they've all run away
screaming)


> 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
>
>