Skip to content
GitLab
Projects Groups Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
  • M MathJax
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 304
    • Issues 304
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 15
    • Merge requests 15
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Packages and registries
    • Packages and registries
    • Package Registry
    • Infrastructure Registry
  • Monitor
    • Monitor
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • MathJax
  • MathJax
  • Wiki
  • Release process checklist

Release process checklist · Changes

Page history
added: beta-release process (basically a copy); added: check internal version number. authored May 17, 2013 by pkra's avatar pkra
Hide whitespace changes
Inline Side-by-side
Release-process-checklist.md
View page @ bc0b86d1
## For releases
### At GitHub
1. All code changes are internally tested according to the MathJax [[Development Process]], and merged into the `mathjax/master` branch at GitHub. Repack and recombine the files to make sure they are consistent with the unpacked versions.
2. If this is a numbered release, the `vN.M-latest` branch is created, and a README-branch.txt file is made for the version number, and committed to the branch. This makes the branch appear as a separate line in the network viewer.
2. If this is a numbered release, the `vN.M-latest` branch is created, and a README-branch.txt file is made for the version number, and committed to the branch. This makes the branch appear as a separate line in the network viewer. Check that MathJax's internal version is updated as well.
3. The release is tagged in GitHub. This causes a labeled distribution to be created (with the tag name) in the GitHub download manager.
3. Complete the [[Documentation update process]].
4. The download distribution should then be downloaded and smoke tested.
......@@ -26,4 +28,32 @@
* Announcement should be posted to the User Groups at mathjax-dev and mathjax-users
* Advise regarding the CDN propagation (clear browser cache etc)
* The new post should be announced on social media channels [[MathJax-web-presence]].
## For a beta releases
This is almost identical, except that we don't do as much.
### At GitHub
1. All code changes are internally tested according to the MathJax [[Development Process]] and merged into the `mathjax/vN.M-beta` branch at GitHub. Repack and recombine the files to make sure they are consistent with the unpacked versions.
2. The `vN.M-beta` branch is created. This makes the branch appear as a separate line in the network viewer. Check that MathJax's internal version is updated as well.
4. The download distribution should then be downloaded and smoke tested.
### At CDN
1. Upload the new version to the CDN as `vN.M-beta` (and while you're at it, create `vN.M-latest`).
1. Set the custom headers for the fonts (see [[Managing Rackspace Cloud Files & CDN]])
### At mathjax.org
2. A news announcement for the release is posted. The post should
* Describe what is new
* Point to the beta branch and download at github.
* Give instructions for reporting bugs, and refer questions to MathJax User Groups
### For the community
* Announcement should be posted to the User Groups at mathjax-dev and mathjax-users
* The new post should be announced on social media channels [[MathJax-web-presence]].
\ No newline at end of file
Clone repository

MathJax Wiki

  • Contributing
    • Quick guide to translating mathjax
  • Development
    • Development Process
      • Release Process Checklist
      • Hotfix Release Process
      • Documentation Update Process
      • Source Control Policies
    • Design Documents
      • MathJax Roadmap
      • CDN Hosting
        • Managing Rackspace Cloud Files & CDN
        • Directory Structure
        • .htaccess settings
        • Managing Amazon Cloudfront
      • Performance Discussion
      • Profiling and Diagnostics Tools
      • Configuration Options
      • Documentation generation guide
      • Testing
        • Platforms supported
        • Test Machines
  • MathJax web presence
  • Drafts