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
(removing sidebar changes)
m (→‎3 weeks prior: replacing bullet points with numbers)
Line 16: Line 16:
In new version wiki:
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
# 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 MediaWiki:Sitenotice
# Edit MediaWiki:Sitenotice
* Edit Main_page
# Edit Main_page
* Remove new features template from all pages in Category:New_features
# Remove new features template from all pages in Category:New_features
* Edit Template:New_features and Category:New_features
# Edit Template:New_features and Category:New_features
* Go through [https://tracker.moodle.org/issues/?jql=labels%20%3D%20docs_required 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
# Go through [https://tracker.moodle.org/issues/?jql=labels%20%3D%20docs_required 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
# Create https://docs.moodle.org/2x/en/Upgrading_to_Moodle_2.x
* Update version numbers in various places e.g. https://docs.moodle.org/en/Upgrading https://docs.moodle.org/en/Installation_Quickstart https://docs.moodle.org/en/Installing_Moodle https://docs.moodle.org/25/en/Git_for_Administrators
# Update version numbers in various places e.g. https://docs.moodle.org/en/Upgrading https://docs.moodle.org/en/Installation_Quickstart https://docs.moodle.org/en/Installing_Moodle https://docs.moodle.org/25/en/Git_for_Administrators
* Check that the requirements listed in https://docs.moodle.org/en/Installing_Moodle match those in the release notes
# Check that the requirements listed in https://docs.moodle.org/en/Installing_Moodle match those in the release notes
* Edit https://docs.moodle.org/en/Theme_credits if necessary
# 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:WantedPages
* Review https://docs.moodle.org/en/Special:LonelyPages
# Review https://docs.moodle.org/en/Special:LonelyPages
* Document new features in [[:en:New features]]
# Document new features in [[:en:New features]]
* Remove "(new in 2.x)" text
# Remove "(new in 2.x)" text
* 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


==Day of release==
==Day of release==

Revision as of 13:28, 23 April 2014

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

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

3 weeks prior

In new version wiki:

  1. 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
  2. Edit MediaWiki:Sitenotice
  3. Edit Main_page
  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 https://docs.moodle.org/2x/en/Upgrading_to_Moodle_2.x
  8. Update version numbers in various places e.g. https://docs.moodle.org/en/Upgrading https://docs.moodle.org/en/Installation_Quickstart https://docs.moodle.org/en/Installing_Moodle https://docs.moodle.org/25/en/Git_for_Administrators
  9. Check that the requirements listed in https://docs.moodle.org/en/Installing_Moodle match those in the release notes
  10. Edit https://docs.moodle.org/en/Theme_credits if necessary
  11. Review https://docs.moodle.org/en/Special:WantedPages
  12. Review https://docs.moodle.org/en/Special:LonelyPages
  13. Document new features in en:New features
  14. Remove "(new in 2.x)" text
  15. Add link to new version wiki to https://docs.moodle.org/dev/MediaWiki:Sidebar

Day of release

In new version wiki:

  • Edit MediaWiki:Sitenotice

In all older version wikis:

In previous latest version wiki:

Final checks: