[documentation] Documentation session in Vancouver

[Kieran Lal]

On Jan 15, 2006, at 12:18 PM, Charlie Lowe wrote:

> Angie Byron wrote:
>> 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. ;)
>
> There have been lots of good ideas posted in the last week  
> (partially in response to this post). This may seem obvious, but I  
> hope that any "plan of action" will prioritize resources offered.  
> One thing that I notice is that there never seems to be a lack of  
> good ideas, but we often don't have the committment to affect them.  
> Having volunteers to complete a task should weigh in heavily in any  
> plan for action. Better to have smaller improvements which reach  
> completion then plans for bigger and better projects which don't.


> Also keep in mind long term maintenance. It may sound great to add  
> in a whole new section to the handbook in some grand initiative to  
> create additional documentation, but that adds in an extra burden  
> for maintaining the handbooks. This also may come at the expense of  
> refinement of existing documentation. Which would serve Drupal  
> users best? More documentation, or improved documentation? There is  
> a healthy balance in there somewhere, but let's not forget that the  
> handbook has grown greatly in the last year. People from the  
> community seem willing to contribute docs; there seems to be less  
> of a commitment in terms of the number of people willing to refine,  
> revise, update, or reorganize what is in the handbooks. It may be  
> better to prioritize those kinds of efforts to make sure that they  
> happen.
>
This is why it's so important to allow editing by the community.  We  
need all these small contributions to help clean up, it's just too  
much work for the core team.

Cheers,
Kieran

>
>
>
>
> --
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
>