MoodleDocs:Moodle Docs reorganisation: Difference between revisions

Revision as of 14:55, 12 May 2011

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/

@@ Line 2: / Line 2: @@
-The plan for new versions of Moodle is to have:
+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/ ...
-# A table of contents, such as [[2.0]]
-# A version [http://www.mediawiki.org/wiki/Help:Namespaces namespace]
+'Moodle Docs for this page' links at the bottom of each page in Moodle will link to the appropriate version of the documentation.
-==A version namespace==
+The documentation will have a big table of contents and will no longer be separated into teacher and administrator documentation.
-All documentation about Moodle 2.0 will be kept in a 2.0 namespace i.e. each page title and URL will contain '2.0' e.g. 2.0:Forum.
+Developer documentation will be kept in a separate non-version-specific wiki, as developer documentation is usually written about future versions of Moodle.
-The existing teacher and administrator documentation will be cloned (including page histories), updated, tidied up and moved into the 2.0 namespace. When 2.1 is released, the process will be repeated for a 2.1 namespace.
+==2.0 version wiki tidying up==
-# Create a 2.0 namespace as described in http://www.mediawiki.org/wiki/Manual:Using_custom_namespaces
+* Rename all pages with 2.0 in the title e.g. [[Backup 2.0]] and amend all links to these pages
-# Use [[Special:Export]] to export pages from [[:Category:Administrator]] and [[:Category:Teacher]]
+* 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
-# Amend titles in the XML file by searching for <title> and replacing with <title>2.0:
-# Use [[Special:Import]] to import the XML file and create the pages in the 2.0 namespace
-==Tidying up==
+==Documentation in different languages==
-* Amend links within pages - all 2.0 pages should contain links to other 2.0 pages
+''Plan coming soon''...
-* Rename all pages which already had 2.0 in the title e.g. [[Backup 2.0]]
-* Remove references to legacy versions which are no longer maintained, such as [[:Category:Moodle 1.6]] or move to obsolete namespace
-* So that the pages in a category can be sorted according to their actual name, rather than having them all listed under '2.0', create templates for adding pages to major categories e.g. https://docs.moodle.org/test/Template:CategoryAdministrator (so that 2.0:Forum would be listed under F instead of 2.0) then replace <code><nowiki>[[Category:Administrator]]</nowiki></code> with <code><nowiki>{{CategoryAdministrator}}</nowiki></code>
 ==More things to do==
-* Change 'Moodle Docs for this page' links within Moodle 2.0
 * 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]]
-* Redesign [[Main Page]]
+* 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
-* Create a custom search block to enable easy searching for pages in the 2.0 namespace
+* Move the existing English wiki to https://docs.moodle.org/1.9/en/
-==Things to think about==
-* Would version namespaces in the developer documentation be worth having?
-* Should the existing teacher and administrator documentation be moved into a 1.9 namespace? The documentation [[About Moodle]] could remain in the main namespace.
-* Could any of the tidying up be automated or done more efficiently using phpMyAdmin? Or a search and replace of the XML file before importing?
-* Do we need a 2.0 category as well as a 2.0 namespace? Consider [[:Category:Developer]] and the list of [https://docs.moodle.org/en/index.php?title=Special%3AAllPages&from=&namespace=100 all pages in the Development namespace] - are they both necessary?
-* From Eloy: The header automatically can show you: “You are viewing 2.0 doc page, also available : 1.9...”
-* Should templates be included when exporting pages?
-* Would it be helpful for pages in a particular namespace e.g. Development to be styled differently? See http://www.mediawiki.org/wiki/Help:Namespaces#Identifying_namespaces for CSS method.
-* Would anyone want version namespaces for Moodle Docs in other languages?