[drupal-docs] Planning for the Drupal 4.7 Documentation Sprint

[Charlie Lowe]

Kieran Lal wrote:
> For 4.7 I am going to  suggest the 
> following additions to admin help: Add pictures, add a  link to file a 
> bug or request a feature.

Before you implement this, I would suggest the following:

* I can imagine that there might be other areas of the administration 
section that could use admin/help documentation before adding pictures. 
Themes and blocks seem a more common need for most users. Perhaps 
assistance with clean URL's? Etc.

* bug and feature request links might be useful for a small percentage 
of the target audience of the admin/help text. But I suspect that it 
might get inadvertently misused by a much larger percentage of people 
merely seeking support or those that haven't well researched whether 
they in fact have a bug, or whether the issue has already been created. 
I see it potentially creating a problem for the Drupal community on 
drupal.org. Could it better to make more visible links to the support 
page on drupal.org instead?

> 
> 2) We need to empower module developers to use administration help.   
> They need to know where to get the documentation, guidelines on how  to 
> convert it into code, and a commitment to get help from the  
> documentation team if they do write or include the documentation.  A  
> mass mail to all the CVS account holders seems like a potential  solution.

I like what you are doing with "How to understand a module so you can 
document it." Having improved documentation writing guidlines in place 
before the mass email is also a plus.

> 
> 3) We need a long term technically viable help solution that involves  
> automatically getting documentation.

+1

> 
> 4) We need Drupal.org to allow anonymous users to contribute pages to  
> the Handbook, especially administration help for modules.  The  barrier 
> to contribute to documentation is currently too high and does  not 
> maintain a consistently high level that a closed documentation  system 
> would normally deliver.

+1

Are we any closer to the means to do this?