Release process

Pre-release

1. Add release notes to docs/modules/ROOT/pages/CHANGELOG.adoc
2. Change version in docs/antora.yml
3. Change version in gradle.properties
4. Commit message: "Prepare x.y.z release"
5. Submit PR and merge approved PR into the main branch

Release

1. Commit and create a tag. Make sure the tag does not have a "v" prefix.

   git tag -a x.y.z -m "Release version x.y.z"
   

2. Push to apple/pkl-lsp

   These instructions assume that the apple/pkl-lsp remote is called "upstream".

   git push upstream x.y.z
   

3. Wait for CI job to finish

4. If a new minor version, create a release branch

   1. git checkout -b release/x.x
   2. push to upstream

5. Otherwise, merge changes into release branch

   1. git checkout release/x.x
   2. git merge --ff-only main
   3. push to upstream