This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch v3-2-test
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/v3-2-test by this push:
new 84b598f025a [v3-2-test] Docs: Add RC shortcut for first release
candidates from test branch (#64528) (#64532)
84b598f025a is described below
commit 84b598f025aae731279004d43e3938011bc50e65
Author: github-actions[bot]
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Wed Apr 1 13:43:35 2026 +0200
[v3-2-test] Docs: Add RC shortcut for first release candidates from test
branch (#64528) (#64532)
* Docs: Add RC shortcut for first release candidates from test branch
* Add RC shortcut docs to release instructions and fix pip install command
(cherry picked from commit f4713de23ce9f2d7d794bab384179566d7d54b81)
Co-authored-by: Jarek Potiuk <[email protected]>
---
dev/README_AIRFLOW3_DEV.md | 11 +++++++++++
dev/README_RELEASE_AIRFLOW.md | 15 +++++++++++++--
2 files changed, 24 insertions(+), 2 deletions(-)
diff --git a/dev/README_AIRFLOW3_DEV.md b/dev/README_AIRFLOW3_DEV.md
index c97431bf042..3c19a28cf6c 100644
--- a/dev/README_AIRFLOW3_DEV.md
+++ b/dev/README_AIRFLOW3_DEV.md
@@ -64,6 +64,17 @@ If you want to have a fix backported to 3.1.x please add (or
request to add) "ba
When preparing a new 3.1.x release, the release manager will sync the
`v3-1-test` branch to `v3-1-stable` and cut the release from the stable branch.
PRs should **never** target `v3-1-stable` directly unless explicitly
instructed by the release manager.
+> [!TIP]
+> **Shortcut for first RC candidates:** When preparing the first RC candidate
for a new minor release
+> (e.g., 3.2.0rc1), it is unlikely to be approved on the first attempt — bugs
are typically found during
+> RC testing. In this case, the release manager can prepare the RC directly
from the `v3-X-test` branch
+> without opening a PR to `v3-X-stable`. This saves the overhead of creating
and managing a PR that will
+> likely need additional changes before GA. However, when using this shortcut,
the release manager **must**
+> verify that the `v3-X-test` push CI action ("Tests" workflow) has succeeded
before cutting the RC. You can
+> check this at:
+>
https://github.com/apache/airflow/actions/workflows/ci-amd-arm.yml?query=event%3Apush+branch%3Av3-2-test
+> (adjust the branch filter for the relevant `v3-X-test` branch).
+
## Developing for Airflow 3
PRs should target `main` branch.
diff --git a/dev/README_RELEASE_AIRFLOW.md b/dev/README_RELEASE_AIRFLOW.md
index ce6dd6864dd..0dc8dec98bc 100644
--- a/dev/README_RELEASE_AIRFLOW.md
+++ b/dev/README_RELEASE_AIRFLOW.md
@@ -500,10 +500,21 @@ uv tool install -e ./dev/breeze
- PR from the 'test' branch to the 'stable' branch
-- When the PR is approved, install `dev/breeze` in a virtualenv:
+> [!TIP]
+> **Shortcut for first RC candidates:** When preparing the first RC candidate
for a new minor release
+> (e.g., 3.2.0rc1), it is unlikely to be approved on the first attempt — bugs
are typically found during
+> RC testing. In this case, the release manager can prepare the RC directly
from the `v3-X-test` branch
+> without opening a PR to `v3-X-stable`. This saves the overhead of creating
and managing a PR that will
+> likely need additional changes before GA. However, when using this shortcut,
the release manager **must**
+> verify that the `v3-X-test` push CI action ("Tests" workflow) has succeeded
before cutting the RC. You can
+> check this at:
+>
https://github.com/apache/airflow/actions/workflows/ci-amd-arm.yml?query=event%3Apush+branch%3Av3-2-test
+> (adjust the branch filter for the relevant `v3-X-test` branch).
+
+- When the PR is approved (or when using the shortcut above), install
`dev/breeze` in a virtualenv:
```shell script
- pip install -e ./dev/breeze
+ uv pip install -e ./dev/breeze
```
- Set `GITHUB_TOKEN` environment variable. Needed in patch release for
generating issue for testing of the RC.
