New docs version process

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-3951.

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 numbers in various places:
   • Upgrading
   • Upgrading_FAQ
   • Installation_Quickstart
   • Installing_Moodle
   • Git_for_Administrators
   • Upgrade_overview
   • Language_packs
   • Language_customization
9. Edit Template:Release_notes to point to new release notes page
10. Edit Theme_credits if necessary
11. Review Special:WantedPages
12. Review Special:LonelyPages
13. Review instances of "(new in 2.x)" text (not always necessary to remove them)
14. Add link to new version wiki to https://docs.moodle.org/dev/MediaWiki:Sidebar
15. Add link to new version wiki to https://docs.moodle.org/en/MoodleDocs:Overview

Day of release

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

In new wiki:

• Remove message in MediaWiki:Sitenotice

In all older version wikis:

• Edit https://docs.moodle.org/en/MediaWiki:MoodleDocsVersionLinks to add the new version and remove older versions (though keeping 2.7 as LTS release)

In previous latest version wiki:

• Edit https://docs.moodle.org/en/MediaWiki:Noarticletext to make it like https://docs.moodle.org/2x-1/en/MediaWiki:Noarticletext
• Edit https://docs.moodle.org/en/Creating_SCORM_Content to make it like https://docs.moodle.org/2x-1/en/Creating_SCORM_Content
• Go through Special:RecentChanges in the previous most recent version wiki and add relevant changes to the new version wiki
• Edit https://docs.moodle.org/en/Awards and add #redirect [[:en:Awards]] so it redirects to the latest version of the page
• Edit https://docs.moodle.org/en/MoodleDocs:Overview and add #redirect [[:en:MoodleDocs:Overview]] so it redirects to the latest version of the page
• Create MediaWiki:Sitenotice by copying content from https://docs.moodle.org/26/en/MediaWiki:Sitenotice

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

Final checks:

• Email notification of watched pages enabled
• Links without version number e.g. https://docs.moodle.org/en/Main_page redirect to the new version wiki
• New version wiki listed in https://docs.moodle.org/overview/