Skip to content

[docs] Update release promotion wait time - #4459

Merged
wuchong merged 5 commits into
apache:mainfrom
wuchong:docs/update-release-promotion-wait
Sep 21, 2026
Merged

wuchong merged 5 commits into
apache:mainfrom
wuchong:docs/update-release-promotion-wait

Conversation

@wuchong

@wuchong wuchong commented Sep 21, 2026

Copy link
Copy Markdown
Member

Purpose

The release guide still asks release managers to wait 24 hours after finalizing a release before announcing it. The current ASF release policy instead requires waiting at least one hour after uploading a new release before updating the project download page or sending announcement emails. Promotion should also wait until the release artifacts are publicly available from all supported distribution channels.

Brief change log

  • Replace the outdated 24-hour wait with the current one-hour post-upload requirement.
  • Move the timing guidance before the website and mailing-list steps so it clearly applies to both.
  • Require availability checks for Apache downloads, Maven Central, PyPI, crates.io, and the three Docker Hub images before promotion.
  • Add the Python and Rust client registries to the finalization checklist.
  • Add the Fluss and Gateway Docker Hub URLs plus the PyPI and crates.io release URLs to the announcement email template.
  • Update the ASF release policy link to the current section anchor.

Tests

  • git diff --check
  • Docusaurus client and server compilation completed successfully with npm run build -- --no-minify; the final link check remains blocked by pre-existing broken links in the Fluss 0.7 and 0.8 release blog posts.

API and Format

No API or storage format changes.

Documentation

Updates the release management guide to match the current ASF release policy.

Generative AI disclosure

  • Yes — Codex (GPT-5)

Align the release guide with the current ASF policy by replacing the outdated 24-hour wait with the one-hour post-upload requirement for download page updates and announcement emails.

Co-Authored-By: Codex <noreply@openai.com>

AI-Model: gpt-5
AI-Contributed/Feature: 4/4
AI-Contributed/UT: 0/0
Require release managers to confirm that the Apache downloads, Maven, PyPI, and crates.io artifacts are publicly available before merging website updates or sending announcements.

Co-Authored-By: Codex <noreply@openai.com>

AI-Model: gpt-5
AI-Contributed/Feature: 9/9
AI-Contributed/UT: 0/0
Require the final Fluss, Gateway, and Quickstart images to be publicly available on Docker Hub before website updates or release announcements.

Co-Authored-By: Codex <noreply@openai.com>

AI-Model: gpt-5
AI-Contributed/Feature: 2/2
AI-Contributed/UT: 0/0
Include the final Fluss and Gateway Docker image pages together with the PyPI and crates.io release pages in the announcement email template.

Co-Authored-By: Codex <noreply@openai.com>

AI-Model: gpt-5
AI-Contributed/Feature: 10/10
AI-Contributed/UT: 0/0
Combine the artifact availability and one-hour waiting requirements into a single sentence, keeping the waiting period at the end.

Co-Authored-By: Codex <noreply@openai.com>

AI-Model: gpt-5
AI-Contributed/Feature: 5/5
AI-Contributed/UT: 0/0
@wuchong
wuchong merged commit 55ccd0d into apache:main Sep 21, 2026
1 check passed
@wuchong
wuchong deleted the docs/update-release-promotion-wait branch September 21, 2026 14:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant