Release Process

Jump to bottom Edit New page

Peter Ng edited this page Apr 23, 2021 · 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 release branch and switch to it by 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 ./runok.js docs to build documentation
Commit all changes, push and create a PR
Check that all tests pass and merge your PR
Run ./runok.js release to publish latest release. The website will be updated.

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

Post announcements in Twitter & Slack

Updating the website

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