[documentation] The handbook organization

[Kieran Lal]

On Aug 29, 2006, at 11:12 PM, Steven Peck wrote:

> So…. It's been eight months since I re-did the handbook…. Anyone  
> tried 4.8/5.0?  Thoughts, suggestions?  It's a bit different.  I  
> have some rather radical thoughts but really want to hear other  
> people's suggestions first.
First, I would like to see a documentation survey done again.   We  
had 200 responses to the first one and it helped us to discover the  
previous categorization.  I'd like to see someone step forward to  
fund an online categorization exercise if possible.  $100-400.

Second, much of what needs to be improved in the handbook is evident  
from the summary pages we have put together.
http://drupal.org/handbook/comments  -- handbook pages with comments
	- mostly advanced development topics which indicates a need for  
strong technical editing
http://drupal.org/moderation-queue --moderation queue
	-again more advanced development topics
http://drupal.org/handbook/most-popular-pages -- most popular
	-Most popular continues to be dominated by about Drupal, installing  
Drupal, basic configuration, and upgrading.   Site recipes only has  
50K page views, Drupal gallery has 120K indicating that there is not  
a strong a demand for this information as other information.

Third, most popular search terms should be incorporated into the  
handbook design.  Perhaps a frequently updated tag cloud.
	Anonymous users: # cck (193) , # filemanager (155) , # tinymce  
(143) , # flexinode (142) , # gallery (131)
	Authenticated users:     * cck (136), * sort flexinode (90), *  
customizing login (79), * views (70), * TinyMCE (67)

Putting together a much better About section for Drupal would  
probably have a bigger impact and more people would read it.   Re- 
organizations are time consuming and without some audience research  
to back them up, I would question if this was a useful effort.

I'd rather see more videos addressing About Drupal, Installing  
Drupal, and basic configuration.

Cheers,
Kieran
> Steven

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.drupal.org/pipermail/documentation/attachments/20060830/914dcdbf/attachment.htm