This is the process we follow when releasing a new version of Cesium Native.

Prepare for Release

Verify that CI is passing on all platforms. Fix it if not.
Verify that CHANGES.md is complete and accurate.
- Give the header of the section containing the latest changes an appropriate version number and date.
- Diff main against the previous released version. This helps catch changes that are missing from the changelog, as well as changelog entries that were accidentally added to the wrong section.
Set the version property in package.json.
Set the VERSION property passed to the project() function in CMakeLists.txt.
Commit these changes. You can push them directly to main.

Release

Releasing is simply a matter of tagging the release and pushing the tag to GitHub. Replace the version number with the one used in the preparation steps above.

git tag -a v0.56.0 -m "0.56.0 release"
git push origin v0.56.0

Publish Updated Reference Docs

A CI job automatically publishes the documentation to the web site at https://cesium.com/learn/cesium-native/ref-doc/ when it is merged into the cesium.com branch. So do the following:

git checkout cesium.com
git pull --ff-only
git merge v0.56.0 --ff-only
git push
git checkout main

The --ff-only flags ensure that no new commits are created in the process. We only want to bring over commits from the release tag. If the pull or merge fails, something unusual has probably happened with the git history and it warrants a little investigation before proceeding.