Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

New docs version process: Difference between revisions

From MoodleDocs
(→‎3 weeks prior: post about new version wikis)
(Check (and update if needed) Upgrading and Upgrade overview pages)
Line 8: Line 8:
# Edit https://docs.moodle.org/en/Special:DoubleRedirects (ignoring redirects to dev docs)
# Edit https://docs.moodle.org/en/Special:DoubleRedirects (ignoring redirects to dev docs)
# Check and delete as necessary https://docs.moodle.org/en/Special:NewFiles
# Check and delete as necessary https://docs.moodle.org/en/Special:NewFiles
# Check and delete as necessary https://docs.moodle.org/en/Special:ListDuplicatedFiles
# Check and delete as necessary https://docs.moodle.org/en/Special:ListDuplicatedFiles
# Check and delete as necessary https://docs.moodle.org/en/Special:UnusedFiles
# Check and delete as necessary https://docs.moodle.org/en/Special:UnusedFiles
# (Check and delete as necessary https://docs.moodle.org/en/Special:ShortPages )
# (Check and delete as necessary https://docs.moodle.org/en/Special:ShortPages )
Line 30: Line 30:
# Review instances of "(new in 3.x)" text (not always necessary to remove them)
# Review instances of "(new in 3.x)" text (not always necessary to remove them)
# Add link to new version wiki to https://docs.moodle.org/dev/MediaWiki:Sidebar
# Add link to new version wiki to https://docs.moodle.org/dev/MediaWiki:Sidebar
# Add link to new version wiki to https://docs.moodle.org/en/MoodleDocs:Overview
# Add link to new version wiki to https://docs.moodle.org/en/MoodleDocs:Overview
# Post on moodle.org in the Moodle community sites forum about the new version wikis e.g. [https://moodle.org/mod/forum/discuss.php?d=404029 Moodle Docs 3.9 wikis now available]
# Post on moodle.org in the Moodle community sites forum about the new version wikis e.g. [https://moodle.org/mod/forum/discuss.php?d=404029 Moodle Docs 3.9 wikis now available]


Line 40: Line 40:


* Remove message in MediaWiki:Sitenotice
* Remove message in MediaWiki:Sitenotice
* Check (and update if needed) Upgrading and Upgrade overview pages


In all older version wikis:
In all older version wikis:

Revision as of 14:17, 17 June 2020

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

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
  14. Post on moodle.org in the Moodle community sites forum about the new version wikis e.g. Moodle Docs 3.9 wikis now available

1 week prior

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

In new wiki:

  • Remove message in MediaWiki:Sitenotice
  • Check (and update if needed) Upgrading and Upgrade overview pages

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