|
| 1 | +--- |
| 2 | +name: Release |
| 3 | +about: Schedule a release |
| 4 | +--- |
| 5 | + |
| 6 | +## Main Release |
| 7 | + |
| 8 | +Released quarterly on January 2nd, April 1st, July 1st and October 15th. |
| 9 | + |
| 10 | +* [ ] Open a release ticket e.g. https://github.com/python-pillow/Pillow/issues/3154 |
| 11 | +* [ ] Develop and prepare release in `main` branch. |
| 12 | + * [ ] Add release notes for 11.2.1 https://github.com/python-pillow/Pillow/pull/8885 |
| 13 | +* [ ] Check [GitHub Actions](https://github.com/python-pillow/Pillow/actions) to confirm passing tests in `main` branch. |
| 14 | +* [ ] 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. |
| 15 | +* [ ] In compliance with [PEP 440](https://peps.python.org/pep-0440/), update version identifier in `src/PIL/_version.py` |
| 16 | +* [ ] Run pre-release check via `make release-test` in a freshly cloned repo. |
| 17 | +* [ ] Create branch and tag for release e.g.: |
| 18 | + ```bash |
| 19 | + git branch [[MAJOR.MINOR.PATCH]] |
| 20 | + git tag [[MAJOR.MINOR.PATCH]] |
| 21 | + git push --tags |
| 22 | + ``` |
| 23 | +* [ ] 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. |
| 24 | +* [ ] Publish the [release on GitHub](https://github.com/python-pillow/Pillow/releases). |
| 25 | +* [ ] 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: |
| 26 | + ```bash |
| 27 | + git push --all |
| 28 | + ``` |
| 29 | + |
| 30 | +## Publicize Release |
| 31 | + |
| 32 | +* [ ] Announce release availability via [Mastodon](https://fosstodon.org/@pillow) e.g. https://fosstodon.org/@pillow/110639450470725321 |
| 33 | + |
| 34 | +## Documentation |
| 35 | + |
| 36 | +* [ ] Make sure the [default version for Read the Docs](https://pillow.readthedocs.io/en/stable/) is up-to-date with the release changes |
| 37 | + |
| 38 | +## Docker Images |
| 39 | + |
| 40 | +* [ ] Update Pillow in the Docker Images repository |
| 41 | + ```bash |
| 42 | + git clone https://github.com/python-pillow/docker-images |
| 43 | + cd docker-images |
| 44 | + ./update-pillow-tag.sh [[release tag]] |
| 45 | + ``` |
0 commit comments