From c8176c98e7a65070070c99f9cf52a616b2c3a2b3 Mon Sep 17 00:00:00 2001
From: Jarek Potiuk <jarek@potiuk.com>
Date: Tue, 24 Jun 2025 10:18:55 +0200
Subject: [PATCH] Add few small improvements in publishing workflow:

* allow to use any reference not only tag when publishing docs
* autocomplete destinations for publish-to-s3 command
---
 ..._release-management_publish-docs-to-s3.svg | 44 ++++++++++++-------
 ..._release-management_publish-docs-to-s3.txt |  2 +-
 .../output_workflow-run_publish-docs.svg      | 28 +++++++-----
 .../output_workflow-run_publish-docs.txt      |  2 +-
 .../commands/release_management_commands.py   |  2 +
 .../commands/workflow_commands.py             | 31 ++++++++-----
 .../commands/workflow_commands_config.py      |  1 +
 .../src/airflow_breeze/global_constants.py    |  5 +++
 8 files changed, 75 insertions(+), 40 deletions(-)

diff --git a/dev/breeze/doc/images/output_release-management_publish-docs-to-s3.svg b/dev/breeze/doc/images/output_release-management_publish-docs-to-s3.svg
index 85823e8559ed5..f9714ff976f05 100644
--- a/dev/breeze/doc/images/output_release-management_publish-docs-to-s3.svg
+++ b/dev/breeze/doc/images/output_release-management_publish-docs-to-s3.svg
@@ -1,4 +1,4 @@
-<svg class="rich-terminal" viewBox="0 0 1482 562.4" xmlns="http://www.w3.org/2000/svg">
+<svg class="rich-terminal" viewBox="0 0 1482 635.5999999999999" xmlns="http://www.w3.org/2000/svg">
     <!-- Generated with Rich https://www.textualize.io -->
     <style>
 
@@ -45,7 +45,7 @@
 
     <defs>
     <clipPath id="breeze-release-management-publish-docs-to-s3-clip-terminal">
-      <rect x="0" y="0" width="1463.0" height="511.4" />
+      <rect x="0" y="0" width="1463.0" height="584.5999999999999" />
     </clipPath>
     <clipPath id="breeze-release-management-publish-docs-to-s3-line-0">
     <rect x="0" y="1.5" width="1464" height="24.65"/>
@@ -107,9 +107,18 @@
 <clipPath id="breeze-release-management-publish-docs-to-s3-line-19">
     <rect x="0" y="465.1" width="1464" height="24.65"/>
             </clipPath>
+<clipPath id="breeze-release-management-publish-docs-to-s3-line-20">
+    <rect x="0" y="489.5" width="1464" height="24.65"/>
+            </clipPath>
+<clipPath id="breeze-release-management-publish-docs-to-s3-line-21">
+    <rect x="0" y="513.9" width="1464" height="24.65"/>
+            </clipPath>
+<clipPath id="breeze-release-management-publish-docs-to-s3-line-22">
+    <rect x="0" y="538.3" width="1464" height="24.65"/>
+            </clipPath>
     </defs>
 
-    <rect fill="#292929" stroke="rgba(255,255,255,0.35)" stroke-width="1" x="1" y="1" width="1480" height="560.4" rx="8"/><text class="breeze-release-management-publish-docs-to-s3-title" fill="#c5c8c6" text-anchor="middle" x="740" y="27">Command:&#160;release-management&#160;publish-docs-to-s3</text>
+    <rect fill="#292929" stroke="rgba(255,255,255,0.35)" stroke-width="1" x="1" y="1" width="1480" height="633.6" rx="8"/><text class="breeze-release-management-publish-docs-to-s3-title" fill="#c5c8c6" text-anchor="middle" x="740" y="27">Command:&#160;release-management&#160;publish-docs-to-s3</text>
             <g transform="translate(26,22)">
             <circle cx="0" cy="0" r="7" fill="#ff5f57"/>
             <circle cx="22" cy="0" r="7" fill="#febc2e"/>
@@ -126,20 +135,23 @@
 </text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="117.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-4)">
 </text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="142" textLength="24.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-5)">╭─</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="24.4" y="142" textLength="244" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-5)">&#160;Publish&#160;docs&#160;to&#160;S3&#160;</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="268.4" y="142" textLength="1171.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-5)">────────────────────────────────────────────────────────────────────────────────────────────────</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1439.6" y="142" textLength="24.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-5)">─╮</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="142" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-5)">
 </text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="166.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-6)">│</text><text class="breeze-release-management-publish-docs-to-s3-r6" x="24.4" y="166.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-6)">*</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="166.4" textLength="207.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-6)">--source-dir-path</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="166.4" textLength="671" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-6)">Path&#160;to&#160;the&#160;directory&#160;with&#160;the&#160;generated&#160;documentation.</text><text class="breeze-release-management-publish-docs-to-s3-r7" x="1146.8" y="166.4" textLength="73.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-6)">(TEXT)</text><text class="breeze-release-management-publish-docs-to-s3-r8" x="1232.2" y="166.4" textLength="122" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-6)">[required]</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="166.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-6)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="166.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-6)">
-</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="190.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-7)">│</text><text class="breeze-release-management-publish-docs-to-s3-r6" x="24.4" y="190.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-7)">*</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="190.8" textLength="268.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-7)">--destination-location</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="190.8" textLength="658.8" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-7)">Name&#160;of&#160;the&#160;S3&#160;bucket&#160;to&#160;publish&#160;the&#160;documentation&#160;to.</text><text class="breeze-release-management-publish-docs-to-s3-r7" x="1134.6" y="190.8" textLength="73.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-7)">(TEXT)</text><text class="breeze-release-management-publish-docs-to-s3-r8" x="1220" y="190.8" textLength="122" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-7)">[required]</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="190.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-7)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="190.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-7)">
-</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="215.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-8)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="215.2" textLength="170.8" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-8)">--exclude-docs</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="215.2" textLength="854" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-8)">Comma&#160;separated&#160;list&#160;of&#160;directories&#160;to&#160;exclude&#160;from&#160;the&#160;documentation.</text><text class="breeze-release-management-publish-docs-to-s3-r7" x="1329.8" y="215.2" textLength="73.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-8)">(TEXT)</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="215.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-8)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="215.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-8)">
-</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="239.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-9)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="239.6" textLength="109.8" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-9)">--dry-run</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="239.6" textLength="488" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-9)">Dry&#160;run&#160;-&#160;only&#160;print&#160;what&#160;would&#160;be&#160;done.</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="239.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-9)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="239.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-9)">
-</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="264" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-10)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="264" textLength="134.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-10)">--overwrite</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="264" textLength="512.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-10)">Overwrite&#160;existing&#160;files&#160;in&#160;the&#160;S3&#160;bucket.</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="264" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-10)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="264" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-10)">
-</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="288.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-11)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="288.4" textLength="158.6" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-11)">--parallelism</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="288.4" textLength="915" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-11)">Maximum&#160;number&#160;of&#160;processes&#160;to&#160;use&#160;while&#160;running&#160;the&#160;operation&#160;in&#160;parallel.</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="288.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-11)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="288.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-11)">
-</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="312.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-12)">│</text><text class="breeze-release-management-publish-docs-to-s3-r7" x="463.6" y="312.8" textLength="915" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-12)">(INTEGER&#160;RANGE)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="312.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-12)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="312.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-12)">
-</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="337.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-13)">│</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="463.6" y="337.2" textLength="915" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-13)">[default:&#160;4;&#160;1&lt;=x&lt;=8]&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="337.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-13)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="337.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-13)">
-</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="361.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-14)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="361.6" textLength="207.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-14)">--stable-versions</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="361.6" textLength="829.6" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-14)">Publish&#160;all&#160;the&#160;stable&#160;versions&#160;of&#160;the&#160;docs&#160;in&#160;the&#160;source&#160;directory.</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="361.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-14)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="361.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-14)">
-</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="386" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-15)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="386" textLength="219.6" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-15)">--publish-all-docs</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="386" textLength="671" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-15)">Publish&#160;all&#160;the&#160;available&#160;docs&#160;in&#160;the&#160;source&#160;directory.</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="386" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-15)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="386" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-15)">
-</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="410.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-16)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="410.4" textLength="353.8" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-16)">--skip-write-to-stable-folder</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="410.4" textLength="439.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-16)">Skip&#160;writing&#160;stable&#160;versions&#160;folder.</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="410.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-16)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="410.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-16)">
-</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="434.8" textLength="1464" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-17)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="434.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-17)">
-</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="459.2" textLength="24.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-18)">╭─</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="24.4" y="459.2" textLength="195.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-18)">&#160;Common&#160;options&#160;</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="219.6" y="459.2" textLength="1220" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-18)">────────────────────────────────────────────────────────────────────────────────────────────────────</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1439.6" y="459.2" textLength="24.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-18)">─╮</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="459.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-18)">
-</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="483.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-19)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="24.4" y="483.6" textLength="73.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-19)">--help</text><text class="breeze-release-management-publish-docs-to-s3-r9" x="122" y="483.6" textLength="24.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-19)">-h</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="170.8" y="483.6" textLength="329.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-19)">Show&#160;this&#160;message&#160;and&#160;exit.</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="483.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-19)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="483.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-19)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="190.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-7)">│</text><text class="breeze-release-management-publish-docs-to-s3-r6" x="24.4" y="190.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-7)">*</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="190.8" textLength="268.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-7)">--destination-location</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="190.8" textLength="976" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-7)">Name&#160;of&#160;the&#160;S3&#160;bucket&#160;to&#160;publish&#160;the&#160;documentation&#160;to.&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="190.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-7)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="190.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-7)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="215.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-8)">│</text><text class="breeze-release-management-publish-docs-to-s3-r7" x="463.6" y="215.2" textLength="976" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-8)">(s3://live-docs-airflow-apache-org/docs/&#160;|&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="215.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-8)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="215.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-8)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="239.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-9)">│</text><text class="breeze-release-management-publish-docs-to-s3-r7" x="463.6" y="239.6" textLength="976" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-9)">s3://staging-docs-airflow-apache-org/docs/)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="239.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-9)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="239.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-9)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="264" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-10)">│</text><text class="breeze-release-management-publish-docs-to-s3-r8" x="463.6" y="264" textLength="976" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-10)">[required]&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="264" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-10)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="264" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-10)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="288.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-11)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="288.4" textLength="170.8" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-11)">--exclude-docs</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="288.4" textLength="854" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-11)">Comma&#160;separated&#160;list&#160;of&#160;directories&#160;to&#160;exclude&#160;from&#160;the&#160;documentation.</text><text class="breeze-release-management-publish-docs-to-s3-r7" x="1329.8" y="288.4" textLength="73.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-11)">(TEXT)</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="288.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-11)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="288.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-11)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="312.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-12)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="312.8" textLength="109.8" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-12)">--dry-run</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="312.8" textLength="488" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-12)">Dry&#160;run&#160;-&#160;only&#160;print&#160;what&#160;would&#160;be&#160;done.</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="312.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-12)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="312.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-12)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="337.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-13)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="337.2" textLength="134.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-13)">--overwrite</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="337.2" textLength="512.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-13)">Overwrite&#160;existing&#160;files&#160;in&#160;the&#160;S3&#160;bucket.</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="337.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-13)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="337.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-13)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="361.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-14)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="361.6" textLength="158.6" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-14)">--parallelism</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="361.6" textLength="915" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-14)">Maximum&#160;number&#160;of&#160;processes&#160;to&#160;use&#160;while&#160;running&#160;the&#160;operation&#160;in&#160;parallel.</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="361.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-14)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="361.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-14)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="386" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-15)">│</text><text class="breeze-release-management-publish-docs-to-s3-r7" x="463.6" y="386" textLength="915" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-15)">(INTEGER&#160;RANGE)&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="386" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-15)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="386" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-15)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="410.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-16)">│</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="463.6" y="410.4" textLength="915" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-16)">[default:&#160;4;&#160;1&lt;=x&lt;=8]&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="410.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-16)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="410.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-16)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="434.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-17)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="434.8" textLength="207.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-17)">--stable-versions</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="434.8" textLength="829.6" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-17)">Publish&#160;all&#160;the&#160;stable&#160;versions&#160;of&#160;the&#160;docs&#160;in&#160;the&#160;source&#160;directory.</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="434.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-17)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="434.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-17)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="459.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-18)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="459.2" textLength="219.6" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-18)">--publish-all-docs</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="459.2" textLength="671" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-18)">Publish&#160;all&#160;the&#160;available&#160;docs&#160;in&#160;the&#160;source&#160;directory.</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="459.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-18)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="459.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-18)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="483.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-19)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="61" y="483.6" textLength="353.8" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-19)">--skip-write-to-stable-folder</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="463.6" y="483.6" textLength="439.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-19)">Skip&#160;writing&#160;stable&#160;versions&#160;folder.</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="483.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-19)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="483.6" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-19)">
 </text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="508" textLength="1464" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-20)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="508" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-20)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="532.4" textLength="24.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-21)">╭─</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="24.4" y="532.4" textLength="195.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-21)">&#160;Common&#160;options&#160;</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="219.6" y="532.4" textLength="1220" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-21)">────────────────────────────────────────────────────────────────────────────────────────────────────</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1439.6" y="532.4" textLength="24.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-21)">─╮</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="532.4" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-21)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="556.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-22)">│</text><text class="breeze-release-management-publish-docs-to-s3-r4" x="24.4" y="556.8" textLength="73.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-22)">--help</text><text class="breeze-release-management-publish-docs-to-s3-r9" x="122" y="556.8" textLength="24.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-22)">-h</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="170.8" y="556.8" textLength="329.4" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-22)">Show&#160;this&#160;message&#160;and&#160;exit.</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="1451.8" y="556.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-22)">│</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="556.8" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-22)">
+</text><text class="breeze-release-management-publish-docs-to-s3-r5" x="0" y="581.2" textLength="1464" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-23)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text class="breeze-release-management-publish-docs-to-s3-r1" x="1464" y="581.2" textLength="12.2" clip-path="url(#breeze-release-management-publish-docs-to-s3-line-23)">
 </text>
     </g>
     </g>
diff --git a/dev/breeze/doc/images/output_release-management_publish-docs-to-s3.txt b/dev/breeze/doc/images/output_release-management_publish-docs-to-s3.txt
index 52bbf87766612..e4fb5d52989a4 100644
--- a/dev/breeze/doc/images/output_release-management_publish-docs-to-s3.txt
+++ b/dev/breeze/doc/images/output_release-management_publish-docs-to-s3.txt
@@ -1 +1 @@
-870594f56b40b6394366a382221f29f5
+568376d5841031b748c6021beef486b5
diff --git a/dev/breeze/doc/images/output_workflow-run_publish-docs.svg b/dev/breeze/doc/images/output_workflow-run_publish-docs.svg
index bd76a72646445..55e3af4f0c3dd 100644
--- a/dev/breeze/doc/images/output_workflow-run_publish-docs.svg
+++ b/dev/breeze/doc/images/output_workflow-run_publish-docs.svg
@@ -1,4 +1,4 @@
-<svg class="rich-terminal" viewBox="0 0 1482 684.4" xmlns="http://www.w3.org/2000/svg">
+<svg class="rich-terminal" viewBox="0 0 1482 733.1999999999999" xmlns="http://www.w3.org/2000/svg">
     <!-- Generated with Rich https://www.textualize.io -->
     <style>
 
@@ -45,7 +45,7 @@
 
     <defs>
     <clipPath id="breeze-workflow-run-publish-docs-clip-terminal">
-      <rect x="0" y="0" width="1463.0" height="633.4" />
+      <rect x="0" y="0" width="1463.0" height="682.1999999999999" />
     </clipPath>
     <clipPath id="breeze-workflow-run-publish-docs-line-0">
     <rect x="0" y="1.5" width="1464" height="24.65"/>
@@ -122,9 +122,15 @@
 <clipPath id="breeze-workflow-run-publish-docs-line-24">
     <rect x="0" y="587.1" width="1464" height="24.65"/>
             </clipPath>
+<clipPath id="breeze-workflow-run-publish-docs-line-25">
+    <rect x="0" y="611.5" width="1464" height="24.65"/>
+            </clipPath>
+<clipPath id="breeze-workflow-run-publish-docs-line-26">
+    <rect x="0" y="635.9" width="1464" height="24.65"/>
+            </clipPath>
     </defs>
 
-    <rect fill="#292929" stroke="rgba(255,255,255,0.35)" stroke-width="1" x="1" y="1" width="1480" height="682.4" rx="8"/><text class="breeze-workflow-run-publish-docs-title" fill="#c5c8c6" text-anchor="middle" x="740" y="27">Command:&#160;workflow-run&#160;publish-docs</text>
+    <rect fill="#292929" stroke="rgba(255,255,255,0.35)" stroke-width="1" x="1" y="1" width="1480" height="731.2" rx="8"/><text class="breeze-workflow-run-publish-docs-title" fill="#c5c8c6" text-anchor="middle" x="740" y="27">Command:&#160;workflow-run&#160;publish-docs</text>
             <g transform="translate(26,22)">
             <circle cx="0" cy="0" r="7" fill="#ff5f57"/>
             <circle cx="22" cy="0" r="7" fill="#febc2e"/>
@@ -153,13 +159,15 @@
 </text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="410.4" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-16)">
 </text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="434.8" textLength="24.4" clip-path="url(#breeze-workflow-run-publish-docs-line-17)">╭─</text><text class="breeze-workflow-run-publish-docs-r5" x="24.4" y="434.8" textLength="378.2" clip-path="url(#breeze-workflow-run-publish-docs-line-17)">&#160;Trigger&#160;publish&#160;docs&#160;workflow&#160;</text><text class="breeze-workflow-run-publish-docs-r5" x="402.6" y="434.8" textLength="1037" clip-path="url(#breeze-workflow-run-publish-docs-line-17)">─────────────────────────────────────────────────────────────────────────────────────</text><text class="breeze-workflow-run-publish-docs-r5" x="1439.6" y="434.8" textLength="24.4" clip-path="url(#breeze-workflow-run-publish-docs-line-17)">─╮</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="434.8" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-17)">
 </text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="459.2" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-18)">│</text><text class="breeze-workflow-run-publish-docs-r6" x="24.4" y="459.2" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-18)">*</text><text class="breeze-workflow-run-publish-docs-r4" x="61" y="459.2" textLength="61" clip-path="url(#breeze-workflow-run-publish-docs-line-18)">--ref</text><text class="breeze-workflow-run-publish-docs-r1" x="463.6" y="459.2" textLength="646.6" clip-path="url(#breeze-workflow-run-publish-docs-line-18)">Git&#160;reference&#160;tag&#160;to&#160;checkout&#160;to&#160;build&#160;documentation.</text><text class="breeze-workflow-run-publish-docs-r7" x="1122.4" y="459.2" textLength="73.2" clip-path="url(#breeze-workflow-run-publish-docs-line-18)">(TEXT)</text><text class="breeze-workflow-run-publish-docs-r8" x="1207.8" y="459.2" textLength="122" clip-path="url(#breeze-workflow-run-publish-docs-line-18)">[required]</text><text class="breeze-workflow-run-publish-docs-r5" x="1451.8" y="459.2" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-18)">│</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="459.2" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-18)">
-</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="483.6" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-19)">│</text><text class="breeze-workflow-run-publish-docs-r4" x="61" y="483.6" textLength="170.8" clip-path="url(#breeze-workflow-run-publish-docs-line-19)">--exclude-docs</text><text class="breeze-workflow-run-publish-docs-r1" x="463.6" y="483.6" textLength="805.2" clip-path="url(#breeze-workflow-run-publish-docs-line-19)">Comma&#160;separated&#160;list&#160;of&#160;docs&#160;packages&#160;to&#160;exclude&#160;from&#160;the&#160;publish.</text><text class="breeze-workflow-run-publish-docs-r7" x="1281" y="483.6" textLength="73.2" clip-path="url(#breeze-workflow-run-publish-docs-line-19)">(TEXT)</text><text class="breeze-workflow-run-publish-docs-r5" x="1451.8" y="483.6" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-19)">│</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="483.6" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-19)">
-</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="508" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-20)">│</text><text class="breeze-workflow-run-publish-docs-r4" x="61" y="508" textLength="122" clip-path="url(#breeze-workflow-run-publish-docs-line-20)">--site-env</text><text class="breeze-workflow-run-publish-docs-r1" x="463.6" y="508" textLength="671" clip-path="url(#breeze-workflow-run-publish-docs-line-20)">S3&#160;bucket&#160;to&#160;which&#160;the&#160;documentation&#160;will&#160;be&#160;published.</text><text class="breeze-workflow-run-publish-docs-r7" x="1146.8" y="508" textLength="280.6" clip-path="url(#breeze-workflow-run-publish-docs-line-20)">(auto&#160;|&#160;live&#160;|&#160;staging)</text><text class="breeze-workflow-run-publish-docs-r5" x="1451.8" y="508" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-20)">│</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="508" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-20)">
-</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="532.4" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-21)">│</text><text class="breeze-workflow-run-publish-docs-r4" x="61" y="532.4" textLength="353.8" clip-path="url(#breeze-workflow-run-publish-docs-line-21)">--skip-write-to-stable-folder</text><text class="breeze-workflow-run-publish-docs-r1" x="463.6" y="532.4" textLength="366" clip-path="url(#breeze-workflow-run-publish-docs-line-21)">Skip&#160;writing&#160;to&#160;stable&#160;folder.</text><text class="breeze-workflow-run-publish-docs-r5" x="1451.8" y="532.4" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-21)">│</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="532.4" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-21)">
-</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="556.8" textLength="1464" clip-path="url(#breeze-workflow-run-publish-docs-line-22)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="556.8" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-22)">
-</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="581.2" textLength="24.4" clip-path="url(#breeze-workflow-run-publish-docs-line-23)">╭─</text><text class="breeze-workflow-run-publish-docs-r5" x="24.4" y="581.2" textLength="195.2" clip-path="url(#breeze-workflow-run-publish-docs-line-23)">&#160;Common&#160;options&#160;</text><text class="breeze-workflow-run-publish-docs-r5" x="219.6" y="581.2" textLength="1220" clip-path="url(#breeze-workflow-run-publish-docs-line-23)">────────────────────────────────────────────────────────────────────────────────────────────────────</text><text class="breeze-workflow-run-publish-docs-r5" x="1439.6" y="581.2" textLength="24.4" clip-path="url(#breeze-workflow-run-publish-docs-line-23)">─╮</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="581.2" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-23)">
-</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="605.6" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-24)">│</text><text class="breeze-workflow-run-publish-docs-r4" x="24.4" y="605.6" textLength="73.2" clip-path="url(#breeze-workflow-run-publish-docs-line-24)">--help</text><text class="breeze-workflow-run-publish-docs-r9" x="122" y="605.6" textLength="24.4" clip-path="url(#breeze-workflow-run-publish-docs-line-24)">-h</text><text class="breeze-workflow-run-publish-docs-r1" x="170.8" y="605.6" textLength="329.4" clip-path="url(#breeze-workflow-run-publish-docs-line-24)">Show&#160;this&#160;message&#160;and&#160;exit.</text><text class="breeze-workflow-run-publish-docs-r5" x="1451.8" y="605.6" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-24)">│</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="605.6" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-24)">
-</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="630" textLength="1464" clip-path="url(#breeze-workflow-run-publish-docs-line-25)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="630" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-25)">
+</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="483.6" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-19)">│</text><text class="breeze-workflow-run-publish-docs-r4" x="61" y="483.6" textLength="256.2" clip-path="url(#breeze-workflow-run-publish-docs-line-19)">--skip-tag-validation</text><text class="breeze-workflow-run-publish-docs-r1" x="463.6" y="483.6" textLength="976" clip-path="url(#breeze-workflow-run-publish-docs-line-19)">Skip&#160;validation&#160;of&#160;the&#160;tag.&#160;Allows&#160;to&#160;use&#160;`main`&#160;or&#160;commit&#160;hash.&#160;Use&#160;with&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="breeze-workflow-run-publish-docs-r5" x="1451.8" y="483.6" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-19)">│</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="483.6" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-19)">
+</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="508" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-20)">│</text><text class="breeze-workflow-run-publish-docs-r1" x="463.6" y="508" textLength="976" clip-path="url(#breeze-workflow-run-publish-docs-line-20)">caution.&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;&#160;</text><text class="breeze-workflow-run-publish-docs-r5" x="1451.8" y="508" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-20)">│</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="508" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-20)">
+</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="532.4" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-21)">│</text><text class="breeze-workflow-run-publish-docs-r4" x="61" y="532.4" textLength="170.8" clip-path="url(#breeze-workflow-run-publish-docs-line-21)">--exclude-docs</text><text class="breeze-workflow-run-publish-docs-r1" x="463.6" y="532.4" textLength="805.2" clip-path="url(#breeze-workflow-run-publish-docs-line-21)">Comma&#160;separated&#160;list&#160;of&#160;docs&#160;packages&#160;to&#160;exclude&#160;from&#160;the&#160;publish.</text><text class="breeze-workflow-run-publish-docs-r7" x="1281" y="532.4" textLength="73.2" clip-path="url(#breeze-workflow-run-publish-docs-line-21)">(TEXT)</text><text class="breeze-workflow-run-publish-docs-r5" x="1451.8" y="532.4" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-21)">│</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="532.4" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-21)">
+</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="556.8" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-22)">│</text><text class="breeze-workflow-run-publish-docs-r4" x="61" y="556.8" textLength="122" clip-path="url(#breeze-workflow-run-publish-docs-line-22)">--site-env</text><text class="breeze-workflow-run-publish-docs-r1" x="463.6" y="556.8" textLength="671" clip-path="url(#breeze-workflow-run-publish-docs-line-22)">S3&#160;bucket&#160;to&#160;which&#160;the&#160;documentation&#160;will&#160;be&#160;published.</text><text class="breeze-workflow-run-publish-docs-r7" x="1146.8" y="556.8" textLength="280.6" clip-path="url(#breeze-workflow-run-publish-docs-line-22)">(auto&#160;|&#160;live&#160;|&#160;staging)</text><text class="breeze-workflow-run-publish-docs-r5" x="1451.8" y="556.8" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-22)">│</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="556.8" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-22)">
+</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="581.2" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-23)">│</text><text class="breeze-workflow-run-publish-docs-r4" x="61" y="581.2" textLength="353.8" clip-path="url(#breeze-workflow-run-publish-docs-line-23)">--skip-write-to-stable-folder</text><text class="breeze-workflow-run-publish-docs-r1" x="463.6" y="581.2" textLength="366" clip-path="url(#breeze-workflow-run-publish-docs-line-23)">Skip&#160;writing&#160;to&#160;stable&#160;folder.</text><text class="breeze-workflow-run-publish-docs-r5" x="1451.8" y="581.2" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-23)">│</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="581.2" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-23)">
+</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="605.6" textLength="1464" clip-path="url(#breeze-workflow-run-publish-docs-line-24)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="605.6" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-24)">
+</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="630" textLength="24.4" clip-path="url(#breeze-workflow-run-publish-docs-line-25)">╭─</text><text class="breeze-workflow-run-publish-docs-r5" x="24.4" y="630" textLength="195.2" clip-path="url(#breeze-workflow-run-publish-docs-line-25)">&#160;Common&#160;options&#160;</text><text class="breeze-workflow-run-publish-docs-r5" x="219.6" y="630" textLength="1220" clip-path="url(#breeze-workflow-run-publish-docs-line-25)">────────────────────────────────────────────────────────────────────────────────────────────────────</text><text class="breeze-workflow-run-publish-docs-r5" x="1439.6" y="630" textLength="24.4" clip-path="url(#breeze-workflow-run-publish-docs-line-25)">─╮</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="630" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-25)">
+</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="654.4" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-26)">│</text><text class="breeze-workflow-run-publish-docs-r4" x="24.4" y="654.4" textLength="73.2" clip-path="url(#breeze-workflow-run-publish-docs-line-26)">--help</text><text class="breeze-workflow-run-publish-docs-r9" x="122" y="654.4" textLength="24.4" clip-path="url(#breeze-workflow-run-publish-docs-line-26)">-h</text><text class="breeze-workflow-run-publish-docs-r1" x="170.8" y="654.4" textLength="329.4" clip-path="url(#breeze-workflow-run-publish-docs-line-26)">Show&#160;this&#160;message&#160;and&#160;exit.</text><text class="breeze-workflow-run-publish-docs-r5" x="1451.8" y="654.4" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-26)">│</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="654.4" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-26)">
+</text><text class="breeze-workflow-run-publish-docs-r5" x="0" y="678.8" textLength="1464" clip-path="url(#breeze-workflow-run-publish-docs-line-27)">╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯</text><text class="breeze-workflow-run-publish-docs-r1" x="1464" y="678.8" textLength="12.2" clip-path="url(#breeze-workflow-run-publish-docs-line-27)">
 </text>
     </g>
     </g>
diff --git a/dev/breeze/doc/images/output_workflow-run_publish-docs.txt b/dev/breeze/doc/images/output_workflow-run_publish-docs.txt
index 053b44077f68b..b64cbd5c82a07 100644
--- a/dev/breeze/doc/images/output_workflow-run_publish-docs.txt
+++ b/dev/breeze/doc/images/output_workflow-run_publish-docs.txt
@@ -1 +1 @@
-75a6fa574a8867b8a681f4792aa21a3c
+aee3662a42543b525bf4ccfd23adaf62
diff --git a/dev/breeze/src/airflow_breeze/commands/release_management_commands.py b/dev/breeze/src/airflow_breeze/commands/release_management_commands.py
index f9cf24bae709c..012830b619392 100644
--- a/dev/breeze/src/airflow_breeze/commands/release_management_commands.py
+++ b/dev/breeze/src/airflow_breeze/commands/release_management_commands.py
@@ -96,6 +96,7 @@
     APACHE_AIRFLOW_GITHUB_REPOSITORY,
     CURRENT_PYTHON_MAJOR_MINOR_VERSIONS,
     DEFAULT_PYTHON_MAJOR_MINOR_VERSION,
+    DESTINATION_LOCATIONS,
     MULTI_PLATFORM,
     UV_VERSION,
 )
@@ -3899,6 +3900,7 @@ def generate_issue_content(
 @click.option(
     "--destination-location",
     help="Name of the S3 bucket to publish the documentation to.",
+    type=NotVerifiedBetterChoice(DESTINATION_LOCATIONS),
     required=True,
 )
 @click.option(
diff --git a/dev/breeze/src/airflow_breeze/commands/workflow_commands.py b/dev/breeze/src/airflow_breeze/commands/workflow_commands.py
index 5f1225ad93f92..d0003cc88172f 100644
--- a/dev/breeze/src/airflow_breeze/commands/workflow_commands.py
+++ b/dev/breeze/src/airflow_breeze/commands/workflow_commands.py
@@ -51,6 +51,11 @@ def workflow_run():
     help="Git reference tag to checkout to build documentation.",
     required=True,
 )
+@click.option(
+    "--skip-tag-validation",
+    help="Skip validation of the tag. Allows to use `main` or commit hash. Use with caution.",
+    is_flag=True,
+)
 @click.option(
     "--exclude-docs",
     help="Comma separated list of docs packages to exclude from the publish.",
@@ -72,6 +77,7 @@ def workflow_run_publish(
     ref: str,
     exclude_docs: str,
     site_env: str,
+    skip_tag_validation: bool,
     doc_packages: tuple[str, ...],
     skip_write_to_stable_folder: bool = False,
 ):
@@ -79,20 +85,21 @@ def workflow_run_publish(
         f"[blue]Validating ref: {ref}[/blue]",
     )
 
-    tag_result = run_command(
-        ["gh", "api", f"repos/apache/airflow/git/refs/tags/{ref}"],
-        capture_output=True,
-        check=False,
-    )
+    if not skip_tag_validation:
+        tag_result = run_command(
+            ["gh", "api", f"repos/apache/airflow/git/refs/tags/{ref}"],
+            capture_output=True,
+            check=False,
+        )
 
-    stdout = tag_result.stdout.decode("utf-8")
-    tag_respo = json.loads(stdout)
+        stdout = tag_result.stdout.decode("utf-8")
+        tag_respo = json.loads(stdout)
 
-    if not tag_respo.get("ref"):
-        get_console().print(
-            f"[red]Error: Ref {ref} is not exists in repo apache/airflow .[/red]",
-        )
-        sys.exit(1)
+        if not tag_respo.get("ref"):
+            get_console().print(
+                f"[red]Error: Ref {ref} does not exists in repo apache/airflow .[/red]",
+            )
+            sys.exit(1)
 
     get_console().print(
         f"[blue]Triggering workflow {WORKFLOW_NAME_MAPS['publish-docs']}: at {APACHE_AIRFLOW_REPO}[/blue]",
diff --git a/dev/breeze/src/airflow_breeze/commands/workflow_commands_config.py b/dev/breeze/src/airflow_breeze/commands/workflow_commands_config.py
index 6a5025dcf9bfb..3ffb4e92f117d 100644
--- a/dev/breeze/src/airflow_breeze/commands/workflow_commands_config.py
+++ b/dev/breeze/src/airflow_breeze/commands/workflow_commands_config.py
@@ -27,6 +27,7 @@
             "name": "Trigger publish docs workflow",
             "options": [
                 "--ref",
+                "--skip-tag-validation",
                 "--exclude-docs",
                 "--site-env",
                 "--skip-write-to-stable-folder",
diff --git a/dev/breeze/src/airflow_breeze/global_constants.py b/dev/breeze/src/airflow_breeze/global_constants.py
index 8d280006f1db3..a7c8096576c4d 100644
--- a/dev/breeze/src/airflow_breeze/global_constants.py
+++ b/dev/breeze/src/airflow_breeze/global_constants.py
@@ -208,6 +208,11 @@
     "task-sdk",
 ]
 
+DESTINATION_LOCATIONS = [
+    "s3://live-docs-airflow-apache-org/docs/",
+    "s3://staging-docs-airflow-apache-org/docs/",
+]
+
 
 @clearable_cache
 def all_selective_core_test_types() -> tuple[str, ...]: