[documentation] Feedback requested: some proposed handbook edits

[Steven Peck]

Been busy at werk

> -----Original Message-----
> From: documentation-bounces at drupal.org [mailto:documentation-
> bounces at drupal.org] On Behalf Of Walter Rader
> Sent: Friday, June 15, 2007 7:42 PM
> To: documentation at drupal.org
> Subject: [documentation] Feedback requested: some proposed handbook
> edits
> 
> 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.

End users are not Drupal.org users.  A Drupal.org user is the site
implementer or developer or a drupal based site.  The end user guide is
meant as a base for a developer/implementer to customize to their site
implementations needs.


> 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.

Multiple contributors mean multiple coverage.  There is an issue in the
queue to consolidate all those pages.  Someone was working on it.


> 
> 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.

Open in a different window?  People can do that now with right-click open in
new window and the _blank attribute has been depreciated I believe.  In any
case the person responsible for editing the theme on drupal.org won't add
that feature so it's not worth pursuing.

-Steven