[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