About 4 weeks ago I committed a patch for gallery module that integrates with advanced_help module (written and used for Views module). The idea behind advanced_help is to store help documentation in a subfolder as regular html pages, what makes it really easy especially for non-developers to help maintaining the docs. As a first step I converted the G2 filter help and added the install tutorial (from codex) to the module. Also a simple helper function allows to map help topics to form elements on the administration pages of gallery module. Take a look at the 'Filter' tab (admin/settings/gallery/filter) and you will find a small icon (?) in front of the description. Basically we can have this kind of extra help for every element on the admin pages.

What I had in mind ... we now can basically use the same docs for on-line help and for off-site documentation in the gallery codex (http://codex.gallery2.org/Integration:Drupal). I hope this makes it easier for people without coding experience to jump on to help with the docs. I suggest that you write a few lines of help text for a certain option/form/problem etc. then put this into a textfile and attach it to this thread mentioning where it should be added. Thx.

Comments

profix898’s picture

The advanced_help module (http://drupal.org/project/advanced_help) automatically generates a TOC of all available help topics (see admin/advanced_help/gallery).

P.S. There are some other issues about documentation (http://drupal.org/node/44479, http://drupal.org/node/226683, http://drupal.org/node/135402).