MoodleDocs:Moodle Docs reorganisation: Difference between revisions
Helen Foster (talk | contribs) (version namespace, tidying up, more things to do, things to think about) |
Helen Foster (talk | contribs) (removing work-in-progress note) |
||
(One intermediate revision by the same user not shown) | |||
Line 1: | Line 1: | ||
'''Note:''' This page is for analysing and figuring out how best to reorganise Moodle Docs for 2.0 and beyond. | |||
The plan for new | The plan for each new stable version of Moodle is to copy the existing wiki to a new wiki for the new version. The version number will be included in the URL 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. | |||
==Documentation in different languages== | |||
There are currently Moodle Docs wikis in 28 different languages. The [https://spreadsheets.google.com/ccc?key=0AmamVlPpCnn4dE1CVmZlemgtLWNxSjZ2cDB3TzQwb1E&hl=en&authkey=CLyez8UP#gid=0 Moodle Docs review 2011] lists the number of pages and users for each wiki, plus information on recent changes. | |||
# | |||
''Moodle Docs contributors, please consider which of the following options you think would be most appropriate for your language:'' | |||
# Existing wiki copied to a new wiki for the new version of Moodle (as for the English wiki) | |||
# Continuation with existing wiki and mixing documentation for new versions of Moodle with documentation for older versions | |||
# Archive of existing wiki and 'Moodle Docs for this page' linking to the English documentation | |||
# Deletion of existing wiki | |||
The [https://docs.moodle.org/overview/ Moodle Docs overview] will be updated to provide links to all wikis, with headings such as '1.9 legacy documentation (may include 2.x docs mixed in)', ' 2.0 documentation', '2.1 documentation', ... | |||
For languages which choose to continue with the existing wiki, it will be moved to a new URL docs.moodle.org/1.9/xx/. 'Moodle Docs for this page' links in Moodle 2.0 and future versions will automatically redirect to the new URL. | |||
For wikis with no recent activity in the last 60 days, unless volunteers come forwards, the existing wiki will be archived. The archived wiki will be moved to a new URL such as docs.moodle.org/old/xx/. A link to the archived wiki will be included in the Moodle Docs overview page, however 'Moodle Docs for this page' links will no longer redirect to the archived wiki. Instead there will be redirects to the en wiki. | |||
For wikis with very few pages, wiki admins will be asked whether they would like the wiki to be deleted. | |||
* | ==See also== | ||
* | |||
* MDLSITE-1279 - META: Moodle Docs reorganisation | |||
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=176065 Update on Moodle 2.0 Docs] forum discussion | |||
Latest revision as of 15:09, 27 March 2013
Note: This page is for analysing and figuring out how best to reorganise Moodle Docs for 2.0 and beyond.
The plan for each new stable version of Moodle is to copy the existing wiki to a new wiki for the new version. The version number will be included in the URL 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.
Documentation in different languages
There are currently Moodle Docs wikis in 28 different languages. The Moodle Docs review 2011 lists the number of pages and users for each wiki, plus information on recent changes.
Moodle Docs contributors, please consider which of the following options you think would be most appropriate for your language:
- Existing wiki copied to a new wiki for the new version of Moodle (as for the English wiki)
- Continuation with existing wiki and mixing documentation for new versions of Moodle with documentation for older versions
- Archive of existing wiki and 'Moodle Docs for this page' linking to the English documentation
- Deletion of existing wiki
The Moodle Docs overview will be updated to provide links to all wikis, with headings such as '1.9 legacy documentation (may include 2.x docs mixed in)', ' 2.0 documentation', '2.1 documentation', ...
For languages which choose to continue with the existing wiki, it will be moved to a new URL docs.moodle.org/1.9/xx/. 'Moodle Docs for this page' links in Moodle 2.0 and future versions will automatically redirect to the new URL.
For wikis with no recent activity in the last 60 days, unless volunteers come forwards, the existing wiki will be archived. The archived wiki will be moved to a new URL such as docs.moodle.org/old/xx/. A link to the archived wiki will be included in the Moodle Docs overview page, however 'Moodle Docs for this page' links will no longer redirect to the archived wiki. Instead there will be redirects to the en wiki.
For wikis with very few pages, wiki admins will be asked whether they would like the wiki to be deleted.
See also
- MDLSITE-1279 - META: Moodle Docs reorganisation
- Using Moodle Update on Moodle 2.0 Docs forum discussion