Skip to content

Record lessons from the October 2026 providers waves in the release docs - #75006

Merged
shahar1 merged 1 commit into
apache:mainfrom
potiuk:release-docs-learnings-2026-10
Oct 18, 2026
Merged

shahar1 merged 1 commit into
apache:mainfrom
potiuk:release-docs-learnings-2026-10

Conversation

@potiuk

@potiuk potiuk commented Oct 18, 2026

Copy link
Copy Markdown
Member

The 2026-10-14 and 2026-10-17 providers waves ran into several steps that dev/README_RELEASE_PROVIDERS.md doesn't cover. This PR writes them down:

  • Inter-provider pin floors: update-providers-next-version only resolves pins an author marked. A provider that starts importing a newer common.compat symbol can ship with too low a floor, even when that provider isn't in the wave (openai and get_async_extra_dejson this time). The doc now has a recipe to find the first release that shipped a symbol, and the prepare-providers-documentation skill now checks for this.
  • Tag the wave at an explicit commit: the wave tag is created at ${WAVE_SHA} rather than at whatever HEAD is, and pushed through ${APACHE_REMOTE}, because the fresh build clone has only origin.
  • Re-cut before the vote email: a new section. Keep the date, check that nothing else touched the wave's providers, move the wave tag, rebuild from the new commit, replace the SVN files (removing dropped ones), and publish the next rcN with an explicit suffix.
  • svn commit needs your terminal: without one (an agent session) it fails with E215004 instead of prompting.
  • Testing issue: testers sometimes confirm a PR only in a comment. Tick those in the previous issue before carrying the ticks over.
  • PyPI token without a terminal: when an agent or script runs the upload, read -s has nowhere to prompt. The doc points to Magpie's secret-prompt, which asks in the terminal or a dialog and passes the token only to twine. That needs feat(secret-prompt): ask the release manager for an upload token without exposing it magpie#1696 to merge first, so the install line works.

Docs only: the prek pre-commit and manual hooks pass on both files.


Was generative AI tooling used to co-author this PR?
  • Yes — Claude Code (Opus 5)

Generated-by: Claude Code (Opus 5) following the guidelines

The 2026-10-14 and 2026-10-17 waves hit steps the instructions did not cover:
a provider outside the wave shipping with a common.compat floor below the
first release that has the symbol it imports, a candidate that had to be
rebuilt before its vote email went out, a build clone with no upstream
remote, an svn commit that cannot prompt from an agent session, tester
confirmations that only lived in issue comments, and a PyPI token prompt that
needs a terminal an agent does not have.

Generated-by: Claude Opus 5
@shahar1
shahar1 merged commit 986066e into apache:main Oct 18, 2026
67 checks passed
@github-actions

Copy link
Copy Markdown
Contributor

Backport successfully created: v3-4-test

Note: As of Merging PRs targeted for Airflow 3.X
the committer who merges the PR is responsible for backporting the PRs that are bug fixes (generally speaking) to the maintenance branches.

In matter of doubt please ask in #release-management Slack channel.

Status Branch Result
✅ v3-4-test PR Link

github-actions Bot pushed a commit to aws-mwaa/upstream-to-airflow that referenced this pull request Oct 18, 2026
…he release docs (apache#75006)

The 2026-10-14 and 2026-10-17 waves hit steps the instructions did not cover:
a provider outside the wave shipping with a common.compat floor below the
first release that has the symbol it imports, a candidate that had to be
rebuilt before its vote email went out, a build clone with no upstream
remote, an svn commit that cannot prompt from an agent session, tester
confirmations that only lived in issue comments, and a PyPI token prompt that
needs a terminal an agent does not have.
(cherry picked from commit 986066e)

Co-authored-by: Jarek Potiuk <jarek@potiuk.com>
Generated-by: Claude Opus 5
aws-airflow-bot pushed a commit to aws-mwaa/upstream-to-airflow that referenced this pull request Oct 18, 2026
…he release docs (apache#75006)

The 2026-10-14 and 2026-10-17 waves hit steps the instructions did not cover:
a provider outside the wave shipping with a common.compat floor below the
first release that has the symbol it imports, a candidate that had to be
rebuilt before its vote email went out, a build clone with no upstream
remote, an svn commit that cannot prompt from an agent session, tester
confirmations that only lived in issue comments, and a PyPI token prompt that
needs a terminal an agent does not have.
(cherry picked from commit 986066e)

Co-authored-by: Jarek Potiuk <jarek@potiuk.com>
Generated-by: Claude Opus 5
potiuk added a commit that referenced this pull request Oct 18, 2026
…he release docs (#75006) (#75008)

The 2026-10-14 and 2026-10-17 waves hit steps the instructions did not cover:
a provider outside the wave shipping with a common.compat floor below the
first release that has the symbol it imports, a candidate that had to be
rebuilt before its vote email went out, a build clone with no upstream
remote, an svn commit that cannot prompt from an agent session, tester
confirmations that only lived in issue comments, and a PyPI token prompt that
needs a terminal an agent does not have.
(cherry picked from commit 986066e)


Generated-by: Claude Opus 5

Co-authored-by: Jarek Potiuk <jarek@potiuk.com>
vatsrahul1001 pushed a commit that referenced this pull request Oct 20, 2026
…he release docs (#75006) (#75008)

The 2026-10-14 and 2026-10-17 waves hit steps the instructions did not cover:
a provider outside the wave shipping with a common.compat floor below the
first release that has the symbol it imports, a candidate that had to be
rebuilt before its vote email went out, a build clone with no upstream
remote, an svn commit that cannot prompt from an agent session, tester
confirmations that only lived in issue comments, and a PyPI token prompt that
needs a terminal an agent does not have.
(cherry picked from commit 986066e)


Generated-by: Claude Opus 5

Co-authored-by: Jarek Potiuk <jarek@potiuk.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants