|
| 1 | +--- |
| 2 | +name: "Maintainers only: Release" |
| 3 | +about: For maintainers to schedule a quarterly release |
| 4 | +labels: Release |
| 5 | +--- |
| 6 | + |
| 7 | +## Main release |
| 8 | + |
| 9 | +Released quarterly on January 2nd, April 1st, July 1st and October 15th. |
| 10 | + |
| 11 | +* [ ] Open a release ticket e.g. https://github.com/python-pillow/Pillow/issues/3154 |
| 12 | +* [ ] Develop and prepare release in `main` branch. |
| 13 | + * [ ] Add release notes e.g. https://github.com/python-pillow/Pillow/pull/8885 |
| 14 | +* [ ] Check [GitHub Actions](https://github.com/python-pillow/Pillow/actions) to confirm passing tests in `main` branch. |
| 15 | +* [ ] Check that all the wheel builds pass the tests in the [GitHub Actions "Wheels" workflow](https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml) jobs by manually triggering them. |
| 16 | +* [ ] In compliance with [PEP 440](https://peps.python.org/pep-0440/), update version identifier in `src/PIL/_version.py` |
| 17 | +* [ ] Run pre-release check via `make release-test` in a freshly cloned repo. |
| 18 | +* [ ] Create branch and tag for release e.g.: |
| 19 | + ```bash |
| 20 | + git branch [[MAJOR.MINOR]].x |
| 21 | + git tag [[MAJOR.MINOR]].0 |
| 22 | + git push --tags |
| 23 | + ``` |
| 24 | +* [ ] Check the [GitHub Actions "Wheels" workflow](https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml) has passed, including the "Upload release to PyPI" job. This will have been triggered by the new tag. |
| 25 | +* [ ] Publish the [release on GitHub](https://github.com/python-pillow/Pillow/releases). |
| 26 | +* [ ] In compliance with [PEP 440](https://peps.python.org/pep-0440/), increment and append `.dev0` to version identifier in `src/PIL/_version.py` and then: |
| 27 | + ```bash |
| 28 | + git push --all |
| 29 | + ``` |
| 30 | + |
| 31 | +## Publicize release |
| 32 | + |
| 33 | +* [ ] Announce release availability via [Mastodon](https://fosstodon.org/@pillow) e.g. https://fosstodon.org/@pillow/110639450470725321 |
| 34 | + |
| 35 | +## Documentation |
| 36 | + |
| 37 | +* [ ] Make sure the [default version for Read the Docs](https://pillow.readthedocs.io/en/stable/) is up-to-date with the release changes |
| 38 | + |
| 39 | +## Docker images |
| 40 | + |
| 41 | +* [ ] Update Pillow in the Docker Images repository |
| 42 | + ```bash |
| 43 | + git clone https://github.com/python-pillow/docker-images |
| 44 | + cd docker-images |
| 45 | + ./update-pillow-tag.sh [[release tag]] |
| 46 | + ``` |
0 commit comments