1.7 KiB
To create and publish a release, perform the following steps:
Create a release branch
In order to make these release-related changes, create a branch in your repository clone. Note that all the examples below use 2.11.0 as the release version, you'll want to use the appropriate version numbers for the release you're working toward.
git checkout -b release-v2.11.0 origin/main
Bump the version in package.json
We use semantic versioning. Set the correct "version" in package.json. Run npm install so package-lock.json can pick up the changes.
Edit CHANGELOG.md: Add the version you are about to release just below the ## Next version heading. Review the changes since the last release and document changes as appropriate.
Commit the changes.
git add package.json package-lock.json CHANGELOG.md
git commit -m "Set version to 2.11.0"
Update README when API docs changed
To build the docs, run
npm run doc
When the above results in changes to README.md, commit these changes to master:
git add README.md
git commit -m "Update API docs in README"
Merge the release branch
Create a pull request and merge the release branch. This allows for any final review of upgrade notes or other parts of the changelog.
Publish to npm
npm publish
Commit release artifacts
git add -f dist
git commit -m "Add dist for v2.11.0"
Create and push a tag
git tag -a v2.11.0 -m "2.11.0"
git push --tags origin
Edit the release notes
The previous step creates a release on GitHub. Copy the changelog for the relese from CHANGELOG.md to the "Describe this release" field for the release notes on https://github.com/openlayers/ol-mapbox-style/releases.