Our release process is very flexible and can be adapted to the needs of the project. We generally aim for a release per week, but we do immediate releases for critical bugs and security issues.
All packages are versioned equally and managed with Changeset.
Before creating a new release, make sure that there are no pending pull requests that should be included in the release.
-
Open the CHANGELOG.md file and add a new section for the new release
We use the Keep a Changelog format, and each release section should look like:
## [VERSION] - <DATE> ### Fixed ### Added ### Changed
-
Using each changeset in the .changeset directory, add the changes to the new release section.
Some things to note:
- If a change is not relevant to the end user, feel free to omit it from the changelog.
- You can edit the changeset content to make it more readable. Every changelog should be easy to understand by the end user, and include some code snippets if possible.
-
Merge the
Version Packages
Pull Request opened by the Changeset GitHub ActionMaintainers: After the release, a Slack message will be sent to the #release channel
-
When the release is complete, create a PR to:
- update the CHANGELOG.md file with the new version.
- Add any lingering documentation.