This page outlines the process for creating a new Fairlearn release. The following steps assume git remote’s origin points to fairlearn/fairlearn (in practical terms, that the work is being done on a clone of fairlearn/fairlearn and not on a fork).
Ensure the maintainers listed in scripts/generate_maintainers_table.py are up to date. Run python scripts/generate_maintainers_table.py from the repository root directory. If the generated file docs/about/maintainers.rst does not change you can proceed with the next step. Otherwise, create a PR to update the generated maintainers file on the main branch. Proceed only when the PR is merged.
Check the docs/user_guide/installation_and_version_guide for a file related to the release. Make sure formatting and contents are correct and create a summary of the highlights at the top of the file. Create a PR for this and merge it before proceeding.
If this is a non-patch release:
Create a new branch:
git checkout -b release/v<x.y>.X
Push the branch to GitHub:
git push -u origin release/v<x.y>.X
On the release branch, create a PR to update the version in __init__.py to x.y.z (where z=0 for the first release from a branch)
Merge that PR.
Run the Release Wheel workflow on GitHub
Ensure that you have selected the correct release branch
On the release branch, place an annotated tag:
git tag -a v<x.y.z> -m "v<x.y.z> release"
Push the tag to GitHub:
git push origin v<x.y.z>
On GitHub’s release page there should be a new release named v<x.y.z>. Open it and post the changes from the release file within docs/user_guide/installation_and_version_guide into the description, then hit “publish”.
On the main branch, create a PR to:
Update the version in __init__.py to x.y.z+1.dev0
Update the version in docs/static_landing_page/js/landing_page.js so that all the links point to the new release
Update the docs_staticversions.json file
Create a new file vx.y.z+1.rst in docs/user_guide/installation_and_version_guide
Make sure to add a note to this second PR: “Do not merge until the release is completed. Otherwise a new website will be published that points to the new version which doesn’t exist yet.”
Merge that PR.