[documentation] Feedback requested: some proposed handbook edits

Walter Rader waltergr at aol.com
Sat Jun 16 02:42:09 UTC 2007


Some opinions/observations:

1. The "End user guide" is a great introductory resource that deserves 
more prominent placement in the handbooks.  Currently it's buried in 
Installation and Configuration, where the target audience (end users) 
will never find it.
2. The "Drupal Terminology" section needs some refactoring.
2a. Example: Some of the material covered in this section is already 
covered in the end-user guide, so it is unnecessary to cover it again if 
the end-user guide were weighted higher.
2b. Example: nodes are defined in "Drupal terminology," again in 
"General concepts," and again in "Terminology."  "Theme engine" is 
defined in "Drupal Explained Simply," then again in "Terminology."  etc.

Suggestions:

I've already done it.  See 
http://waltergr.com/drupalbook/090_about/toc.  The table of contents 
takes forever to load, so I'd recommend keeping that page open in its 
own tab/window and opening the links in new tabs/windows.

The two sections I've worked on are

http://waltergr.com/drupalbook/010_about_drupal_1/002_6261/index
http://waltergr.com/drupalbook/010_about_drupal_1/010_21951/index

Looking forward to any constructive feedback.

Thanks,

Walter



More information about the documentation mailing list