Release process

Instructions assume a correctly configured development environment.

Preparation

1. Determine the new version number (for subsequent steps).
2. Update CHANGELOG.md (review the commit history).
3. Push all commits on main and check all builds pass.

Releasing

1. Change to the src\Draftable.CompareAPI.Client directory.
2. Compile the project: dotnet build -c Release -p:Version=X.Y.Z
3. Build the NuGet package: dotnet pack -c Release -p:Version=X.Y.Z
4. Test the package locally: set up a Nuget repository in a local directory: nuget add C:\newly\built\package.nupkg -Source C:\local-nuget-feed
5. Upload the new release.

Consult the internal documentation (Draftable employees only) for credentials suitable for publishing.

Post-release

1. Add a new Git tag corresponding to the release.
2. Fast-forward the stable branch to match main.
3. Update any internal repositories to use the new version.