MoodleDocs:Moodle Docs reorganisation
Note: This page is for analysing and figuring out how best to reorganise Moodle Docs for 2.0 and beyond. It is a work-in-progress. Comments and suggestions are welcome! Please use the page comments or the Moodle documentation forum.
The plan for each new stable version of Moodle is to copy the existing wiki to a new wiki for the new version e.g. for the English documentation https://docs.moodle.org/2.0/en/, https://docs.moodle.org/2.1/en/ ...
'Moodle Docs for this page' links at the bottom of each page in Moodle will link to the appropriate version of the documentation.
The documentation will have a big table of contents and will no longer be separated into teacher and administrator documentation.
Developer documentation will be kept in a separate non-version-specific wiki, as developer documentation is usually written about future versions of Moodle.
2.0 version wiki tidying up
- Rename all pages with 2.0 in the title e.g. Backup 2.0 and amend all links to these pages
- Remove references to previous versions by deleting sections and pages listed in Category:Moodle 1.6, Category:Moodle 1.7, Category:Moodle 1.8 and Category:Moodle 1.9 and delete all the Moodle version category pages
Documentation in different languages
Plan coming soon...
More things to do
- Go through every page in Moodle and ensure that the 'Moodle Docs for this page' link redirects to the correct documentation page
- Ensure all new features and major improvements as listed in Moodle 2.0 release notes are well-explained
- Completely rewrite Installing Moodle
- Improve Upgrading to Moodle 2.0
- Style the 2.0 wiki differently e.g. coloured stripe or border and add a big 2.0 at the top so that it is obviously different from the 1.9 wiki
- Move the existing English wiki to https://docs.moodle.org/1.9/en/
- Identify the very few pages which are not developer documentation and do not fit into the Moodle version wiki model e.g. Community credits and copy them as HTML pages
