By Will White on

I've been looking over Drupal's documentation from the perspective of a new person and I noticed that its organization is very unconventional, which makes it difficult to find things. Here are my initial observations:

  • Handbook pages do not appear within the context of any version of Drupal. Many projects have a guide that is updated for each release to reduce capability confusion.
  • Terms like snippets, recipes, HOWTO, how-to, mini-modules, and tutorials are thrown around here and there. Organizing these pages and calling them one thing, tutorials for example, would make it much easier to find the steps to solve a problem.

Comments

kitt’s picture

kitt commented

You can join the Documentation group to help reorganize or update the documentation:

http://drupal.org/contribute/documentation

karldied’s picture

karldied commented

Thanks for your comment. I filied an issue at http://drupal.org/node/112923 which requests comments on recommendations on how to employ these terms. Please feel free to comment there too.