Releases

Since we release our site changes as soon as they’re approved, we treat release notes more like Weekly Ships—they’re an announcement of what we’ve done recently.

Because we work in Github, we can take advantage of Github’s automated Release Notes features by tracking releases there.

We publish new release notes right after every sprint cycle. We use semantic versioning for our release versions, which is formatted as v[MAJOR].[MINOR].[PATCH] (example: v2.5.8).

• MAJOR - uptick this number for redesigns or replatforming (rarest)
• MINOR - uptick this number for other changes, or releases containing both changes and bugfixes (most common)
• PATCH - uptick this number for bug fixes only

How to make a new release

You must have admin rights to this repo in order to create new tags and publish new releases.

1. Go to the methods releases page
2. Click "Create a new release"
3. Determine whether this sprint's work is a Major, Minor, or Patch release
4. Under "Choose a tag", enter the new version number and select "Create new tag on publish" (example: v2.5.9).
5. Set Target as the main branch
6. Set the Release title as the new tag number (example: v2.5.9)
7. For release notes, click "Generate Release Notes"
8. Refine and reorganize notes into Added, Updated, and Fixed headings
9. Check box "Set as the latest release"
10. Publish release