I'm just putting this forward to get my ideas, er, documented, particularly regarding the programming side of things in Moodle. As you'll see there are many details that the Documentation Leader still needs to organise.
In a nutshell, here it is:
- Every page in Moodle could have a help button in standard locations (in the header and footer).
- The link this button contains would be automatically generated based on the page URL you are currently on and the current language: eg: http://documentation.moodle.org/course/view/es
- The documentation site could be a MediaWiki, so you would be looking at a Wiki page you could contribute to. If the URL doesn't exist, then a new page is created there and you are invited to help complete it!
- Each language page would contain a clear menu or block allowing us to jump easily between different language versions of that page. This might require slight hacks to MediaWiki, which is fine. I don't know what we could put on the "root" page (eg http://documentation.moodle.org/course/view) but I'm sure someone will think of something! Comparison tools? Auto-choose best language?
- Each page would not only contain official documentation describing all the functions on that page but discussions, tips, links to related resources, notes about different versions, history, rationale, authors, contact details etc. Everyone can easily contribute because it's a single click from their own Moodle. We need to think about the policy on editing rights.
- There would still be a need for non-page related documentation, such as the HTML editor, for example, and overviews for teachers and so on, but they would have a wealth of information to link to, and the names of the links will be obvious (same as the Moodle URLs). These help pages themselves can have simple, standard URLs like http://documentation.moodle.org/editor/spelling/ja which we would hard-code in Moodle code.
- The database is going to be huge because of all the screenshots and languages, so most people won't want to (or need to) install it locally (this allows us to make Moodle much leaner because we won't need all the lang/xx/help files any more!). For those who do want a local copy of the Wiki, we can provide a complete archive of the data so they can set up their own documentation site, and there can be a simple admin variable in Moodle to point those links to the local site instead!
I'm feeling very good about this as a starting point we can achieve in the Moodle code relatively soon - I'm sure the collective brains here will have many more ideas!