New docs version process

Jump to: navigation, search

This page describes the procedures for creating a new Moodle Docs version wiki.

4 weeks prior

Tidying up in current latest version wiki:

  1. Delete https://docs.moodle.org/en/Special:BrokenRedirects
  2. Edit https://docs.moodle.org/en/Special:DoubleRedirects (ignoring redirects to dev docs)
  3. Check and delete as necessary https://docs.moodle.org/en/Special:NewFiles
  4. Check and delete as necessary https://docs.moodle.org/en/Special:ListDuplicatedFiles
  5. Check and delete as necessary https://docs.moodle.org/en/Special:UnusedFiles
  6. (Check and delete as necessary https://docs.moodle.org/en/Special:ShortPages )

Create a tracker issue for creating new en and de version wikis similar to MDLSITE-5392.

3 weeks prior

In new version wiki:

  1. Edit MediaWiki:MoodleDocsVersionLinks
  2. Edit Main_page
  3. Add message to MediaWiki:Sitenotice
  4. Remove new features template from all pages in Category:New_features
  5. Edit Template:New_features and Category:New_features
  6. Go through tracker issues with the docs_required label and the release notes for the upcoming release and add documentation on new features plus the new features template
  7. Create Upgrading_to_Moodle_3.x and redirect to Upgrading
  8. Update version number in Template:Version and Template:Version2 and Git for Administrators
  9. Review Special:WantedPages
  10. Review Special:LonelyPages
  11. Review instances of "(new in 3.x)" text (not always necessary to remove them)
  12. Add link to new version wiki to https://docs.moodle.org/dev/MediaWiki:Sidebar
  13. Add link to new version wiki to https://docs.moodle.org/en/MoodleDocs:Overview

1 week prior

Create a tracker issue for making the new wiki default, similar to MDLSITE-5794.

In new wiki:

  • Remove message in MediaWiki:Sitenotice

In all older version wikis:

Day of release

In previous latest version wiki:

On moodle.org, dev.moodle.org, download.moodle.org and lang.moodle.org in footersitesmap change the version number.

Final checks