From 36985547f30164b8cb8b0a82a7befe2be916f059 Mon Sep 17 00:00:00 2001 From: Joseph Hughes Date: Sun, 6 Sep 2026 13:13:22 -0500 Subject: [PATCH] docs(guide-to-publish): record the conda-forge step The feedstock bot updates the version number and the checksum and nothing else, so a release that changes dependencies needs the recipe corrected by hand. Both releases so far did: 1.0.0 for the move from setuptools to hatchling, 1.0.1 for the pandas lower bound. The guide described the release as finished once develop was reset, and said nothing about conda-forge at all. --- guide-to-publish.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/guide-to-publish.md b/guide-to-publish.md index 70a9a34..73d16c6 100644 --- a/guide-to-publish.md +++ b/guide-to-publish.md @@ -52,6 +52,23 @@ Merging the release pull request into `main` triggers jobs that: Merge the reset pull request to finish the release. +## 4. conda-forge + +A few hours after the upload to PyPI, a bot opens a version pull request on the +[feedstock](https://github.com/conda-forge/modflowapi-feedstock). To start it immediately instead, +open an issue there titled `@conda-forge-admin, please update version`. + +> [!IMPORTANT] +> The bot updates the version number and the checksum, and nothing else. **Check the recipe's +> `host` and `run` requirements against the dependencies the release actually declares**, which are +> the `Requires-Dist` lines of the sdist on PyPI. Both releases so far needed this by hand: 1.0.0 +> because the build backend had moved from setuptools to hatchling, and 1.0.1 because the pandas +> lower bound had been raised. A maintainer can push the correction to the bot's branch. + +Merging the feedstock pull request builds and uploads the package. It does not appear to a solver +until the channel index is regenerated, which takes up to about an hour; the package is visible on +anaconda.org before then. + ## Changelog conventions Release notes are generated from commit messages, so commits merged to `develop` must follow the