Note: You are currently viewing documentation for Moodle 1.9. Up-to-date documentation for the latest stable version is available here: Documentation philosophy.

Documentation philosophy

From MoodleDocs
Revision as of 18:19, 4 December 2005 by Helen Foster (talk | contribs) (category change)

What documentation is required?

  • Documentation for every page in Moodle
  • Additional documentation for
Students
Teachers
Administrators
Developers

Documentation for every page in Moodle

  • Moodle 1.6 will have a button in the header that links to pages in the wiki with the same path as the pages in Moodle e.g. https://docs.moodle.org/wiki/mod/forum/view/.
  • Other languages will have the two-letter language code added e.g. "de".
  • All help that refers to specific moodle pages/functions should be in this tree of pages.

Additional documentation

  • Any other pages created should have short, single-word, lowercase URL names. The reason is to try and keep things generic enough to avoid breaking links later. If the titles are long with many words then we'll have to rename them sooner, which breaks links.