New docs version process

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

Pre-copying tidying up

In 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:ShortPages )

Create tracker issues for creating new en and de version wikis similar to MDLSITE-2198 and MDLSITE-2202.

After copying

In new version wiki:

• Ensure email notification of watched pages is disabled initially - in LocalSettings.php set all the Email settings to False - check in the new wiki that there are no email options in user preferences
• Edit https://docs.moodle.org/en/MediaWiki:Sidebar
• Edit https://docs.moodle.org/en/Main_page
• Remove new features template from all pages in https://docs.moodle.org/en/Category:New_features
• Edit https://docs.moodle.org/en/Template:New_features and https://docs.moodle.org/en/Category:New_features
• 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
• Create https://docs.moodle.org/2x/en/Upgrading_to_Moodle_2.x
• Edit https://docs.moodle.org/en/Upgrading and https://docs.moodle.org/en/Installation_Quickstart
• Edit https://docs.moodle.org/en/Theme_credits if necessary
• Review https://docs.moodle.org/en/Special:WantedPages
• Review https://docs.moodle.org/en/Special:LonelyPages

After release

• Edit https://docs.moodle.org/24/en/MediaWiki:Sidebar
• Edit https://docs.moodle.org/24/en/Main_page
• Edit https://docs.moodle.org/24/en/MediaWiki:Noarticletext to make it like https://docs.moodle.org/23/en/MediaWiki:Noarticletext
• Edit https://docs.moodle.org/24/en/Creating_SCORM_Content to make it like https://docs.moodle.org/23/en/Creating_SCORM_Content

Redirect the following pages to the most recent version to ensure that we only have one copy of them:

• https://docs.moodle.org/24/en/Community_credits
• https://docs.moodle.org/24/en/Documentation_credits
• https://docs.moodle.org/24/en/Translation_credits

Finally:

• Go through https://docs.moodle.org/24/en/Special:RecentChanges and https://docs.moodle.org/23/en/Special:RecentChanges and add relevant changes to the new version wiki
• Enable email notification of watched pages
• Add link to new version wiki to main pages of other wikis
• Add link to new version wiki to https://docs.moodle.org/dev/MediaWiki:Sidebar
• Redirect links without version number e.g. https://docs.moodle.org/en/Main_page to the new version wiki
• Add a link to new version wiki to https://docs.moodle.org/overview/