Release Process

Jump to bottom Edit New page

George Griffiths edited this page Nov 12, 2020 · 5 revisions

This is the guide for maintainers:

Release Process

Pull the latest changes from main branch for release stream e.g. 3.x
Create a branch release-x.x.x and switch to it git checkout -b release-x.x.x
Update version in package.json
Go through the commits for the new release and add them to the CHANGELOG.md:

Changelog should be written for humans (not for robots).
Use simple wording explaining what the change is, how to use a new feature (maybe with a code example) and mention the related issue.
When using #123 a link for issue #123 will be automatically added.
A contributor must be mentioned. We use GitHub names with @ prefix. A link to user profile is automatically added.

Run ./runio.js docs to build documentation
Commit all changes, push and create a PR
Check that all tests pass and merge your PR
Run ./runio.js release to publish latest release. The website will be updated.

To update version for patch release: ./runio.js release patch
To update version for minor release: ./runio.js release minor

Post announcements in Twitter & Slack

Updating the website

Run ./runio.js docs:helpers to build docs from helpers
Run ./runio.js publish:site to update a website