This is an automated email from the ASF dual-hosted git repository.
potiuk pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new 551886eb26 Handle "all-providers" when building documentation (#35069)
551886eb26 is described below
commit 551886eb263c8df0b2eee847dd6725de78bc25fc
Author: Jarek Potiuk <[email protected]>
AuthorDate: Fri Oct 20 11:26:17 2023 +0200
Handle "all-providers" when building documentation (#35069)
---
.../airflow_breeze/commands/developer_commands.py | 15 +++++-----
.../commands/release_management_commands.py | 34 +++++++++-------------
.../src/airflow_breeze/commands/sbom_commands.py | 2 +-
.../src/airflow_breeze/params/doc_build_params.py | 6 ++--
.../src/airflow_breeze/utils/common_options.py | 10 +++----
.../src/airflow_breeze/utils/general_utils.py | 10 ++++++-
images/breeze/output-commands-hash.txt | 8 ++---
images/breeze/output_build-docs.svg | 20 ++++++-------
.../output_release-management_publish-docs.svg | 20 ++++++-------
9 files changed, 64 insertions(+), 61 deletions(-)
diff --git a/dev/breeze/src/airflow_breeze/commands/developer_commands.py
b/dev/breeze/src/airflow_breeze/commands/developer_commands.py
index 17745b8942..7b71e3e707 100644
--- a/dev/breeze/src/airflow_breeze/commands/developer_commands.py
+++ b/dev/breeze/src/airflow_breeze/commands/developer_commands.py
@@ -42,7 +42,7 @@ from airflow_breeze.pre_commit_ids import PRE_COMMIT_LIST
from airflow_breeze.utils.cache import read_from_cache_file
from airflow_breeze.utils.coertions import one_or_none_set
from airflow_breeze.utils.common_options import (
- argument_packages_plus_all_providers_for_shorthand,
+ argument_short_doc_packages_with_providers_index,
option_airflow_constraints_reference,
option_airflow_extras,
option_answer,
@@ -84,6 +84,7 @@ from airflow_breeze.utils.docker_command_utils import (
get_extra_docker_flags,
perform_environment_checks,
)
+from airflow_breeze.utils.general_utils import expand_all_providers
from airflow_breeze.utils.path_utils import (
AIRFLOW_SOURCES_ROOT,
cleanup_python_generated_files,
@@ -177,7 +178,7 @@ def shell(
python: str,
backend: str,
builder: str,
- integration: tuple[str],
+ integration: tuple[str, ...],
postgres_version: str,
mysql_version: str,
mssql_version: str,
@@ -290,7 +291,7 @@ def start_airflow(
python: str,
backend: str,
builder: str,
- integration: tuple[str],
+ integration: tuple[str, ...],
postgres_version: str,
load_example_dags: bool,
load_default_connections: bool,
@@ -365,7 +366,7 @@ def start_airflow(
@main.command(name="build-docs")
@click.option("-d", "--docs-only", help="Only build documentation.",
is_flag=True)
@click.option("-s", "--spellcheck-only", help="Only run spell checking.",
is_flag=True)
-@argument_packages_plus_all_providers_for_shorthand
+@argument_short_doc_packages_with_providers_index
@option_builder
@click.option(
"--package-filter",
@@ -390,13 +391,13 @@ def start_airflow(
@option_verbose
@option_dry_run
def build_docs(
- packages_plus_all_providers: tuple[str],
+ short_doc_packages: tuple[str, ...],
docs_only: bool,
spellcheck_only: bool,
builder: str,
clean_build: bool,
one_pass_only: bool,
- package_filter: tuple[str],
+ package_filter: tuple[str, ...],
github_repository: str,
):
"""
@@ -421,7 +422,7 @@ def build_docs(
spellcheck_only=spellcheck_only,
one_pass_only=one_pass_only,
skip_environment_initialization=True,
- packages_plus_all_providers=packages_plus_all_providers,
+ short_doc_packages=expand_all_providers(short_doc_packages),
)
extra_docker_flags = get_extra_docker_flags(MOUNT_SELECTED)
env = get_env_variables_for_docker_commands(params)
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 533c63c857..d0c079c3c9 100644
--- a/dev/breeze/src/airflow_breeze/commands/release_management_commands.py
+++ b/dev/breeze/src/airflow_breeze/commands/release_management_commands.py
@@ -42,7 +42,6 @@ from airflow_breeze.global_constants import (
MOUNT_ALL,
MOUNT_SELECTED,
MULTI_PLATFORM,
- get_available_documentation_packages,
)
from airflow_breeze.params.shell_params import ShellParams
from airflow_breeze.utils.add_back_references import (
@@ -51,8 +50,8 @@ from airflow_breeze.utils.add_back_references import (
from airflow_breeze.utils.ci_group import ci_group
from airflow_breeze.utils.common_options import (
argument_packages,
- argument_packages_plus_all_providers,
- argument_packages_plus_all_providers_for_shorthand,
+ argument_short_doc_packages,
+ argument_short_doc_packages_with_providers_index,
option_airflow_constraints_mode_ci,
option_airflow_constraints_mode_update,
option_airflow_constraints_reference,
@@ -89,6 +88,7 @@ from airflow_breeze.utils.docker_command_utils import (
get_extra_docker_flags,
perform_environment_checks,
)
+from airflow_breeze.utils.general_utils import expand_all_providers
from airflow_breeze.utils.github import download_constraints_file,
get_active_airflow_versions
from airflow_breeze.utils.parallel import (
GenericRegexpProgressMatcher,
@@ -837,7 +837,7 @@ def run_publish_docs_in_parallel(
)
@click.option("-s", "--override-versioned", help="Overrides versioned
directories.", is_flag=True)
@option_airflow_site_directory
-@argument_packages_plus_all_providers_for_shorthand
+@argument_short_doc_packages_with_providers_index
@click.option(
"--package-filter",
help="List of packages to consider. You can use the full names like
apache-airflow-providers-<provider>, "
@@ -856,8 +856,8 @@ def run_publish_docs_in_parallel(
def publish_docs(
override_versioned: bool,
airflow_site_directory: str,
- packages_plus_all_providers: tuple[str],
- package_filter: tuple[str],
+ short_doc_packages: tuple[str, ...],
+ package_filter: tuple[str, ...],
run_in_parallel: bool,
parallelism: int,
debug_resources: bool,
@@ -871,10 +871,8 @@ def publish_docs(
"Provide the path of cloned airflow-site repo\n"
)
- available_packages = get_available_packages()
- package_filters = package_filter
current_packages = process_package_filters(
- available_packages, package_filters, packages_plus_all_providers
+ get_available_packages(), package_filter,
expand_all_providers(short_doc_packages)
)
print(f"Publishing docs for {len(current_packages)} package(s)")
@@ -903,12 +901,12 @@ def publish_docs(
help="Command to add back references for documentation to make it backward
compatible.",
)
@option_airflow_site_directory
-@argument_packages_plus_all_providers
+@argument_short_doc_packages
@option_verbose
@option_dry_run
def add_back_references(
airflow_site_directory: str,
- packages_plus_all_providers: tuple[str],
+ short_doc_packages: tuple[str, ...],
):
"""Adds back references for documentation generated by build-docs and
publish-docs"""
site_path = Path(airflow_site_directory)
@@ -918,16 +916,12 @@ def add_back_references(
"Provide the path of cloned airflow-site repo\n"
)
sys.exit(1)
- if not packages_plus_all_providers:
+ if not short_doc_packages:
get_console().print(
"\n[error]You need to specify at least one package to generate
back references for\n"
)
sys.exit(1)
- packages = list(packages_plus_all_providers)
- if "all-providers" in packages_plus_all_providers:
- packages.remove("all-providers")
-
packages.extend(get_available_documentation_packages(only_providers=True,
short_version=True))
- start_generating_back_references(site_path, packages)
+ start_generating_back_references(site_path,
list(expand_all_providers(short_doc_packages)))
@release_management.command(
@@ -1403,7 +1397,7 @@ def update_comment(content: str, comment_file: Path) ->
str:
def modify_single_file_constraints(
- constraints_file: Path, updated_constraints: tuple[str] | None,
comment_file: Path | None
+ constraints_file: Path, updated_constraints: tuple[str, ...] | None,
comment_file: Path | None
) -> bool:
constraint_content = constraints_file.read_text()
original_content = constraint_content
@@ -1427,7 +1421,7 @@ def modify_single_file_constraints(
def modify_all_constraint_files(
constraints_repo: Path,
- updated_constraint: tuple[str] | None,
+ updated_constraint: tuple[str, ...] | None,
comit_file: Path | None,
airflow_constrains_mode: str | None,
) -> bool:
@@ -1538,7 +1532,7 @@ def update_constraints(
airflow_versions: str,
commit_message: str,
airflow_constraints_mode: str | None,
- updated_constraint: tuple[str] | None,
+ updated_constraint: tuple[str, ...] | None,
comment_file: Path | None,
) -> None:
if not updated_constraint and not comment_file:
diff --git a/dev/breeze/src/airflow_breeze/commands/sbom_commands.py
b/dev/breeze/src/airflow_breeze/commands/sbom_commands.py
index cefa82cff5..c7425de8d0 100644
--- a/dev/breeze/src/airflow_breeze/commands/sbom_commands.py
+++ b/dev/breeze/src/airflow_breeze/commands/sbom_commands.py
@@ -270,7 +270,7 @@ def update_sbom_information(
def generate_providers_requirements(
airflow_version: str | None,
python: str,
- provider_id: tuple[str],
+ provider_id: tuple[str, ...],
run_in_parallel: bool,
parallelism: int,
debug_resources: bool,
diff --git a/dev/breeze/src/airflow_breeze/params/doc_build_params.py
b/dev/breeze/src/airflow_breeze/params/doc_build_params.py
index 32da209204..267f84ee54 100644
--- a/dev/breeze/src/airflow_breeze/params/doc_build_params.py
+++ b/dev/breeze/src/airflow_breeze/params/doc_build_params.py
@@ -28,7 +28,7 @@ class DocBuildParams:
package_filter: tuple[str]
docs_only: bool
spellcheck_only: bool
- packages_plus_all_providers: tuple[str]
+ short_doc_packages: tuple[str, ...]
skip_environment_initialization: bool = False
one_pass_only: bool = False
github_actions = os.environ.get("GITHUB_ACTIONS", "false")
@@ -44,8 +44,8 @@ class DocBuildParams:
doc_args.append("--one-pass-only")
if AIRFLOW_BRANCH != "main":
doc_args.append("--disable-provider-checks")
- if self.packages_plus_all_providers:
- providers =
get_provider_name_from_short_hand(self.packages_plus_all_providers)
+ if self.short_doc_packages:
+ providers =
get_provider_name_from_short_hand(self.short_doc_packages)
for single_provider in providers:
doc_args.extend(["--package-filter", single_provider])
if self.package_filter:
diff --git a/dev/breeze/src/airflow_breeze/utils/common_options.py
b/dev/breeze/src/airflow_breeze/utils/common_options.py
index c3734dd8e2..7353b4de7e 100644
--- a/dev/breeze/src/airflow_breeze/utils/common_options.py
+++ b/dev/breeze/src/airflow_breeze/utils/common_options.py
@@ -445,19 +445,19 @@ argument_packages = click.argument(
required=False,
type=BetterChoice(get_available_documentation_packages(short_version=True)),
)
-argument_packages_plus_all_providers = click.argument(
- "packages_plus_all_providers",
+argument_short_doc_packages = click.argument(
+ "short_doc_packages",
nargs=-1,
required=False,
type=BetterChoice(["all-providers",
*get_available_documentation_packages(short_version=True)]),
)
-argument_packages_plus_all_providers_for_shorthand = click.argument(
- "packages_plus_all_providers",
+argument_short_doc_packages_with_providers_index = click.argument(
+ "short_doc_packages",
nargs=-1,
required=False,
type=BetterChoice(
- ["all-providers",
*get_available_documentation_packages(short_version=True), PROVIDERS_INDEX_KEY]
+ ["all-providers", PROVIDERS_INDEX_KEY,
*get_available_documentation_packages(short_version=True)]
),
)
diff --git a/dev/breeze/src/airflow_breeze/utils/general_utils.py
b/dev/breeze/src/airflow_breeze/utils/general_utils.py
index 7285b5289e..c0ca2847d1 100644
--- a/dev/breeze/src/airflow_breeze/utils/general_utils.py
+++ b/dev/breeze/src/airflow_breeze/utils/general_utils.py
@@ -16,7 +16,7 @@
# under the License.
from __future__ import annotations
-from airflow_breeze.global_constants import ALL_SPECIAL_DOC_KEYS
+from airflow_breeze.global_constants import ALL_SPECIAL_DOC_KEYS,
get_available_documentation_packages
providers_prefix = "apache-airflow-providers-"
@@ -32,3 +32,11 @@ def get_provider_name_from_short_hand(short_form_providers:
tuple[str]):
parts = "-".join(short_form_provider.split("."))
providers.append(providers_prefix + parts)
return tuple(providers)
+
+
+def expand_all_providers(short_doc_packages: tuple[str, ...]) -> tuple[str,
...]:
+ if "all-providers" in short_doc_packages:
+ packages = [package for package in short_doc_packages if package !=
"all-providers"]
+
packages.extend(get_available_documentation_packages(only_providers=True,
short_version=True))
+ short_doc_packages = tuple(set(packages))
+ return short_doc_packages
diff --git a/images/breeze/output-commands-hash.txt
b/images/breeze/output-commands-hash.txt
index 9fc6763fca..96893d59ea 100644
--- a/images/breeze/output-commands-hash.txt
+++ b/images/breeze/output-commands-hash.txt
@@ -2,7 +2,7 @@
# Please do not solve it but run `breeze setup regenerate-command-images`.
# This command should fix the conflict and regenerate help images that you
have conflict with.
main:c97d8a728bb02c2be73002c4b39d0829
-build-docs:27f59f285448615a47ee2ee22645ef2b
+build-docs:1b1848521361fc7fa711409cf9132108
ci:find-backtracking-candidates:17fe56b867a745e5032a08dfcd3f73ee
ci:fix-ownership:3e5a73533cc96045e72cb258783cfc96
ci:free-space:49af17b032039c05c41a7a8283f365cc
@@ -36,7 +36,7 @@ prod-image:build:20f84ddadc2fe4ae2723b7ccdde0197f
prod-image:pull:3817ef211b023b76df84ee1110ef64dd
prod-image:verify:bd2b78738a7c388dbad6076c41a9f906
prod-image:e9ecd759e51ebd926df3170b29d1d2dc
-release-management:add-back-references:298fd8d5dd342a076037e996f39ba371
+release-management:add-back-references:172430aea7cea87eb4f58807a650b541
release-management:create-minor-branch:a3834afc4aa5d1e98002c9e9e7a9931d
release-management:generate-constraints:01aef235b11e59ed7f10c970a5cdaba7
release-management:generate-issue-content-providers:19c4c98c30b820685e5775a5396aebdf
@@ -45,13 +45,13 @@
release-management:install-provider-packages:34c38aca17d23dbb454fe7a6bfd8e630
release-management:prepare-airflow-package:85d01c57e5b5ee0fb9e5f9d9706ed3b5
release-management:prepare-provider-documentation:d0dbef40ff62a19c966889f3735e747c
release-management:prepare-provider-packages:5a87973bd373d20b6881f6fd62fbeb05
-release-management:publish-docs:130b14797fc4cd5f33d39c8277584f1c
+release-management:publish-docs:d550549e2d0a89522eedfaa1c1498b4a
release-management:release-prod-images:cfbfe8b19fee91fd90718f98ef2fd078
release-management:start-rc-process:b27bd524dd3c89f50a747b60a7e892c1
release-management:start-release:419f48f6a4ff4457cb9de7ff496aebbe
release-management:update-constraints:02ec4b119150e3fdbac52026e94820ef
release-management:verify-provider-packages:96dce5644aad6b37080acf77b3d8de3a
-release-management:856c346e8ec1cf320f656bcfe0af7451
+release-management:a78938d2775ea0253af625ce67dabcbb
sbom:generate-providers-requirements:51e0c660a5f7846ada099e871ebd4c67
sbom:update-sbom-information:653be48be70b4b7ff5172d491aadc694
sbom:b98ded4bbb76f0cb205cea32f3102aee
diff --git a/images/breeze/output_build-docs.svg
b/images/breeze/output_build-docs.svg
index 71e474fd5c..3bfd58210d 100644
--- a/images/breeze/output_build-docs.svg
+++ b/images/breeze/output_build-docs.svg
@@ -160,16 +160,16 @@
<text class="breeze-build-docs-r1" x="1464" y="20" textLength="12.2"
clip-path="url(#breeze-build-docs-line-0)">
</text><text class="breeze-build-docs-r2" x="12.2" y="44.4"
textLength="1439.6"
clip-path="url(#breeze-build-docs-line-1)">Usage:                                                            
[...]
</text><text class="breeze-build-docs-r3" x="12.2" y="68.8"
textLength="1439.6"
clip-path="url(#breeze-build-docs-line-2)">breeze build-docs                                                          
[...]
-</text><text class="breeze-build-docs-r1" x="12.2" y="93.2" textLength="12.2"
clip-path="url(#breeze-build-docs-line-3)">[</text><text
class="breeze-build-docs-r4" x="24.4" y="93.2" textLength="85.4"
clip-path="url(#breeze-build-docs-line-3)">OPTIONS</text><text
class="breeze-build-docs-r1" x="109.8" y="93.2" textLength="36.6"
clip-path="url(#breeze-build-docs-line-3)">] [</text><text
class="breeze-build-docs-r4" x="146.4" y="93.2" textLength="36.6"
clip-path="url(#breeze-build-docs [...]
-</text><text class="breeze-build-docs-r4" x="12.2" y="117.6" textLength="73.2"
clip-path="url(#breeze-build-docs-line-4)">apache</text><text
class="breeze-build-docs-r1" x="85.4" y="117.6" textLength="12.2"
clip-path="url(#breeze-build-docs-line-4)">.</text><text
class="breeze-build-docs-r4" x="97.6" y="117.6" textLength="109.8"
clip-path="url(#breeze-build-docs-line-4)">cassandra</text><text
class="breeze-build-docs-r1" x="207.4" y="117.6" textLength="36.6"
clip-path="url(#breeze-build- [...]
-</text><text class="breeze-build-docs-r4" x="12.2" y="142" textLength="73.2"
clip-path="url(#breeze-build-docs-line-5)">apache</text><text
class="breeze-build-docs-r1" x="85.4" y="142" textLength="12.2"
clip-path="url(#breeze-build-docs-line-5)">.</text><text
class="breeze-build-docs-r4" x="97.6" y="142" textLength="61"
clip-path="url(#breeze-build-docs-line-5)">kafka</text><text
class="breeze-build-docs-r1" x="158.6" y="142" textLength="36.6"
clip-path="url(#breeze-build-docs-line-5)">& [...]
-</text><text class="breeze-build-docs-r4" x="12.2" y="166.4" textLength="97.6"
clip-path="url(#breeze-build-docs-line-6)">arangodb</text><text
class="breeze-build-docs-r1" x="109.8" y="166.4" textLength="36.6"
clip-path="url(#breeze-build-docs-line-6)"> | </text><text
class="breeze-build-docs-r4" x="146.4" y="166.4" textLength="61"
clip-path="url(#breeze-build-docs-line-6)">asana</text><text
class="breeze-build-docs-r1" x="207.4" y="166.4" textLength="36.6"
clip-path="url(#bree [...]
-</text><text class="breeze-build-docs-r4" x="12.2" y="190.8" textLength="85.4"
clip-path="url(#breeze-build-docs-line-7)">datadog</text><text
class="breeze-build-docs-r1" x="97.6" y="190.8" textLength="36.6"
clip-path="url(#breeze-build-docs-line-7)"> | </text><text
class="breeze-build-docs-r4" x="134.2" y="190.8" textLength="36.6"
clip-path="url(#breeze-build-docs-line-7)">dbt</text><text
class="breeze-build-docs-r1" x="170.8" y="190.8" textLength="12.2"
clip-path="url(#breeze [...]
-</text><text class="breeze-build-docs-r4" x="12.2" y="215.2"
textLength="109.8"
clip-path="url(#breeze-build-docs-line-8)">hashicorp</text><text
class="breeze-build-docs-r1" x="122" y="215.2" textLength="36.6"
clip-path="url(#breeze-build-docs-line-8)"> | </text><text
class="breeze-build-docs-r4" x="158.6" y="215.2" textLength="48.8"
clip-path="url(#breeze-build-docs-line-8)">http</text><text
class="breeze-build-docs-r1" x="207.4" y="215.2" textLength="36.6"
clip-path="url(#bre [...]
-</text><text class="breeze-build-docs-r4" x="12.2" y="239.6"
textLength="109.8"
clip-path="url(#breeze-build-docs-line-9)">microsoft</text><text
class="breeze-build-docs-r1" x="122" y="239.6" textLength="12.2"
clip-path="url(#breeze-build-docs-line-9)">.</text><text
class="breeze-build-docs-r4" x="134.2" y="239.6" textLength="61"
clip-path="url(#breeze-build-docs-line-9)">winrm</text><text
class="breeze-build-docs-r1" x="195.2" y="239.6" textLength="36.6"
clip-path="url(#breeze-build-doc [...]
-</text><text class="breeze-build-docs-r4" x="12.2" y="264" textLength="109.8"
clip-path="url(#breeze-build-docs-line-10)">papermill</text><text
class="breeze-build-docs-r1" x="122" y="264" textLength="36.6"
clip-path="url(#breeze-build-docs-line-10)"> | </text><text
class="breeze-build-docs-r4" x="158.6" y="264" textLength="73.2"
clip-path="url(#breeze-build-docs-line-10)">plexus</text><text
class="breeze-build-docs-r1" x="231.8" y="264" textLength="36.6"
clip-path="url(#breeze [...]
-</text><text class="breeze-build-docs-r1" x="12.2" y="288.4" textLength="24.4"
clip-path="url(#breeze-build-docs-line-11)">| </text><text
class="breeze-build-docs-r4" x="36.6" y="288.4" textLength="48.8"
clip-path="url(#breeze-build-docs-line-11)">smtp</text><text
class="breeze-build-docs-r1" x="85.4" y="288.4" textLength="36.6"
clip-path="url(#breeze-build-docs-line-11)"> | </text><text
class="breeze-build-docs-r4" x="122" y="288.4" textLength="109.8"
clip-path="url(#bree [...]
-</text><text class="breeze-build-docs-r4" x="12.2" y="312.8"
textLength="109.8"
clip-path="url(#breeze-build-docs-line-12)">providers</text><text
class="breeze-build-docs-r1" x="122" y="312.8" textLength="12.2"
clip-path="url(#breeze-build-docs-line-12)">-</text><text
class="breeze-build-docs-r4" x="134.2" y="312.8" textLength="61"
clip-path="url(#breeze-build-docs-line-12)">index</text><text
class="breeze-build-docs-r1" x="195.2" y="312.8" textLength="1256.6"
clip-path="url(#breeze-buil [...]
+</text><text class="breeze-build-docs-r1" x="12.2" y="93.2" textLength="12.2"
clip-path="url(#breeze-build-docs-line-3)">[</text><text
class="breeze-build-docs-r4" x="24.4" y="93.2" textLength="85.4"
clip-path="url(#breeze-build-docs-line-3)">OPTIONS</text><text
class="breeze-build-docs-r1" x="109.8" y="93.2" textLength="36.6"
clip-path="url(#breeze-build-docs-line-3)">] [</text><text
class="breeze-build-docs-r4" x="146.4" y="93.2" textLength="36.6"
clip-path="url(#breeze-build-docs [...]
+</text><text class="breeze-build-docs-r4" x="12.2" y="117.6" textLength="73.2"
clip-path="url(#breeze-build-docs-line-4)">apache</text><text
class="breeze-build-docs-r1" x="85.4" y="117.6" textLength="12.2"
clip-path="url(#breeze-build-docs-line-4)">.</text><text
class="breeze-build-docs-r4" x="97.6" y="117.6" textLength="48.8"
clip-path="url(#breeze-build-docs-line-4)">beam</text><text
class="breeze-build-docs-r1" x="146.4" y="117.6" textLength="36.6"
clip-path="url(#breeze-build-docs-l [...]
+</text><text class="breeze-build-docs-r4" x="12.2" y="142" textLength="73.2"
clip-path="url(#breeze-build-docs-line-5)">apache</text><text
class="breeze-build-docs-r1" x="85.4" y="142" textLength="12.2"
clip-path="url(#breeze-build-docs-line-5)">.</text><text
class="breeze-build-docs-r4" x="97.6" y="142" textLength="73.2"
clip-path="url(#breeze-build-docs-line-5)">impala</text><text
class="breeze-build-docs-r1" x="170.8" y="142" textLength="36.6"
clip-path="url(#breeze-build-docs-line-5) [...]
+</text><text class="breeze-build-docs-r4" x="12.2" y="166.4" textLength="85.4"
clip-path="url(#breeze-build-docs-line-6)">apprise</text><text
class="breeze-build-docs-r1" x="97.6" y="166.4" textLength="36.6"
clip-path="url(#breeze-build-docs-line-6)"> | </text><text
class="breeze-build-docs-r4" x="134.2" y="166.4" textLength="97.6"
clip-path="url(#breeze-build-docs-line-6)">arangodb</text><text
class="breeze-build-docs-r1" x="231.8" y="166.4" textLength="36.6"
clip-path="url(#b [...]
+</text><text class="breeze-build-docs-r4" x="12.2" y="190.8" textLength="122"
clip-path="url(#breeze-build-docs-line-7)">databricks</text><text
class="breeze-build-docs-r1" x="134.2" y="190.8" textLength="36.6"
clip-path="url(#breeze-build-docs-line-7)"> | </text><text
class="breeze-build-docs-r4" x="170.8" y="190.8" textLength="85.4"
clip-path="url(#breeze-build-docs-line-7)">datadog</text><text
class="breeze-build-docs-r1" x="256.2" y="190.8" textLength="36.6"
clip-path="url( [...]
+</text><text class="breeze-build-docs-r4" x="12.2" y="215.2" textLength="73.2"
clip-path="url(#breeze-build-docs-line-8)">google</text><text
class="breeze-build-docs-r1" x="85.4" y="215.2" textLength="36.6"
clip-path="url(#breeze-build-docs-line-8)"> | </text><text
class="breeze-build-docs-r4" x="122" y="215.2" textLength="48.8"
clip-path="url(#breeze-build-docs-line-8)">grpc</text><text
class="breeze-build-docs-r1" x="170.8" y="215.2" textLength="36.6"
clip-path="url(#breeze-b [...]
+</text><text class="breeze-build-docs-r4" x="12.2" y="239.6"
textLength="109.8"
clip-path="url(#breeze-build-docs-line-9)">microsoft</text><text
class="breeze-build-docs-r1" x="122" y="239.6" textLength="12.2"
clip-path="url(#breeze-build-docs-line-9)">.</text><text
class="breeze-build-docs-r4" x="134.2" y="239.6" textLength="48.8"
clip-path="url(#breeze-build-docs-line-9)">psrp</text><text
class="breeze-build-docs-r1" x="183" y="239.6" textLength="36.6"
clip-path="url(#breeze-build-docs [...]
+</text><text class="breeze-build-docs-r4" x="12.2" y="264" textLength="73.2"
clip-path="url(#breeze-build-docs-line-10)">oracle</text><text
class="breeze-build-docs-r1" x="85.4" y="264" textLength="36.6"
clip-path="url(#breeze-build-docs-line-10)"> | </text><text
class="breeze-build-docs-r4" x="122" y="264" textLength="109.8"
clip-path="url(#breeze-build-docs-line-10)">pagerduty</text><text
class="breeze-build-docs-r1" x="231.8" y="264" textLength="36.6"
clip-path="url(#breeze- [...]
+</text><text class="breeze-build-docs-r4" x="12.2" y="288.4"
textLength="134.2"
clip-path="url(#breeze-build-docs-line-11)">singularity</text><text
class="breeze-build-docs-r1" x="146.4" y="288.4" textLength="36.6"
clip-path="url(#breeze-build-docs-line-11)"> | </text><text
class="breeze-build-docs-r4" x="183" y="288.4" textLength="61"
clip-path="url(#breeze-build-docs-line-11)">slack</text><text
class="breeze-build-docs-r1" x="244" y="288.4" textLength="36.6"
clip-path="url(#b [...]
+</text><text class="breeze-build-docs-r4" x="12.2" y="312.8" textLength="85.4"
clip-path="url(#breeze-build-docs-line-12)">zendesk</text><text
class="breeze-build-docs-r1" x="97.6" y="312.8" textLength="1354.2"
clip-path="url(#breeze-build-docs-line-12)">]...                                       
[...]
</text><text class="breeze-build-docs-r1" x="1464" y="337.2" textLength="12.2"
clip-path="url(#breeze-build-docs-line-13)">
</text><text class="breeze-build-docs-r1" x="12.2" y="361.6"
textLength="195.2"
clip-path="url(#breeze-build-docs-line-14)">Build documents.</text><text
class="breeze-build-docs-r1" x="1464" y="361.6" textLength="12.2"
clip-path="url(#breeze-build-docs-line-14)">
</text><text class="breeze-build-docs-r1" x="1464" y="386" textLength="12.2"
clip-path="url(#breeze-build-docs-line-15)">
diff --git a/images/breeze/output_release-management_publish-docs.svg
b/images/breeze/output_release-management_publish-docs.svg
index a6ade4e70d..ad72facea3 100644
--- a/images/breeze/output_release-management_publish-docs.svg
+++ b/images/breeze/output_release-management_publish-docs.svg
@@ -177,16 +177,16 @@
<text class="breeze-release-management-publish-docs-r1" x="1464" y="20"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-0)">
</text><text class="breeze-release-management-publish-docs-r2" x="12.2"
y="44.4" textLength="1439.6"
clip-path="url(#breeze-release-management-publish-docs-line-1)">Usage:                                                     
[...]
</text><text class="breeze-release-management-publish-docs-r3" x="12.2"
y="68.8" textLength="1439.6"
clip-path="url(#breeze-release-management-publish-docs-line-2)">breeze release-management publish-docs                                              
[...]
-</text><text class="breeze-release-management-publish-docs-r1" x="12.2"
y="93.2" textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-3)">[</text><text
class="breeze-release-management-publish-docs-r4" x="24.4" y="93.2"
textLength="85.4"
clip-path="url(#breeze-release-management-publish-docs-line-3)">OPTIONS</text><text
class="breeze-release-management-publish-docs-r1" x="109.8" y="93.2"
textLength="36.6" clip-path="url(#breeze-release-management-publish-docs-lin
[...]
-</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="117.6" textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-4)">apache</text><text
class="breeze-release-management-publish-docs-r1" x="85.4" y="117.6"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-4)">.</text><text
class="breeze-release-management-publish-docs-r4" x="97.6" y="117.6"
textLength="109.8" clip-path="url(#breeze-release-management-publish-docs-l
[...]
-</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="142" textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-5)">apache</text><text
class="breeze-release-management-publish-docs-r1" x="85.4" y="142"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-5)">.</text><text
class="breeze-release-management-publish-docs-r4" x="97.6" y="142"
textLength="61"
clip-path="url(#breeze-release-management-publish-docs-line-5)">k [...]
-</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="166.4" textLength="97.6"
clip-path="url(#breeze-release-management-publish-docs-line-6)">arangodb</text><text
class="breeze-release-management-publish-docs-r1" x="109.8" y="166.4"
textLength="36.6"
clip-path="url(#breeze-release-management-publish-docs-line-6)"> | </text><text
class="breeze-release-management-publish-docs-r4" x="146.4" y="166.4"
textLength="61" clip-path="url(#breeze-release-management-p [...]
-</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="190.8" textLength="85.4"
clip-path="url(#breeze-release-management-publish-docs-line-7)">datadog</text><text
class="breeze-release-management-publish-docs-r1" x="97.6" y="190.8"
textLength="36.6"
clip-path="url(#breeze-release-management-publish-docs-line-7)"> | </text><text
class="breeze-release-management-publish-docs-r4" x="134.2" y="190.8"
textLength="36.6" clip-path="url(#breeze-release-management-p [...]
-</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="215.2" textLength="109.8"
clip-path="url(#breeze-release-management-publish-docs-line-8)">hashicorp</text><text
class="breeze-release-management-publish-docs-r1" x="122" y="215.2"
textLength="36.6"
clip-path="url(#breeze-release-management-publish-docs-line-8)"> | </text><text
class="breeze-release-management-publish-docs-r4" x="158.6" y="215.2"
textLength="48.8" clip-path="url(#breeze-release-management [...]
-</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="239.6" textLength="109.8"
clip-path="url(#breeze-release-management-publish-docs-line-9)">microsoft</text><text
class="breeze-release-management-publish-docs-r1" x="122" y="239.6"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-9)">.</text><text
class="breeze-release-management-publish-docs-r4" x="134.2" y="239.6"
textLength="61" clip-path="url(#breeze-release-management-publish-docs- [...]
-</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="264" textLength="109.8"
clip-path="url(#breeze-release-management-publish-docs-line-10)">papermill</text><text
class="breeze-release-management-publish-docs-r1" x="122" y="264"
textLength="36.6"
clip-path="url(#breeze-release-management-publish-docs-line-10)"> | </text><text
class="breeze-release-management-publish-docs-r4" x="158.6" y="264"
textLength="73.2" clip-path="url(#breeze-release-management-pub [...]
-</text><text class="breeze-release-management-publish-docs-r1" x="12.2"
y="288.4" textLength="24.4"
clip-path="url(#breeze-release-management-publish-docs-line-11)">| </text><text
class="breeze-release-management-publish-docs-r4" x="36.6" y="288.4"
textLength="48.8"
clip-path="url(#breeze-release-management-publish-docs-line-11)">smtp</text><text
class="breeze-release-management-publish-docs-r1" x="85.4" y="288.4"
textLength="36.6" clip-path="url(#breeze-release-management-publish-d [...]
-</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="312.8" textLength="109.8"
clip-path="url(#breeze-release-management-publish-docs-line-12)">providers</text><text
class="breeze-release-management-publish-docs-r1" x="122" y="312.8"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-12)">-</text><text
class="breeze-release-management-publish-docs-r4" x="134.2" y="312.8"
textLength="61" clip-path="url(#breeze-release-management-publish-doc [...]
+</text><text class="breeze-release-management-publish-docs-r1" x="12.2"
y="93.2" textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-3)">[</text><text
class="breeze-release-management-publish-docs-r4" x="24.4" y="93.2"
textLength="85.4"
clip-path="url(#breeze-release-management-publish-docs-line-3)">OPTIONS</text><text
class="breeze-release-management-publish-docs-r1" x="109.8" y="93.2"
textLength="36.6" clip-path="url(#breeze-release-management-publish-docs-lin
[...]
+</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="117.6" textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-4)">apache</text><text
class="breeze-release-management-publish-docs-r1" x="85.4" y="117.6"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-4)">.</text><text
class="breeze-release-management-publish-docs-r4" x="97.6" y="117.6"
textLength="48.8" clip-path="url(#breeze-release-management-publish-docs-li
[...]
+</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="142" textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-5)">apache</text><text
class="breeze-release-management-publish-docs-r1" x="85.4" y="142"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-5)">.</text><text
class="breeze-release-management-publish-docs-r4" x="97.6" y="142"
textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-5)" [...]
+</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="166.4" textLength="85.4"
clip-path="url(#breeze-release-management-publish-docs-line-6)">apprise</text><text
class="breeze-release-management-publish-docs-r1" x="97.6" y="166.4"
textLength="36.6"
clip-path="url(#breeze-release-management-publish-docs-line-6)"> | </text><text
class="breeze-release-management-publish-docs-r4" x="134.2" y="166.4"
textLength="97.6" clip-path="url(#breeze-release-management-p [...]
+</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="190.8" textLength="122"
clip-path="url(#breeze-release-management-publish-docs-line-7)">databricks</text><text
class="breeze-release-management-publish-docs-r1" x="134.2" y="190.8"
textLength="36.6"
clip-path="url(#breeze-release-management-publish-docs-line-7)"> | </text><text
class="breeze-release-management-publish-docs-r4" x="170.8" y="190.8"
textLength="85.4" clip-path="url(#breeze-release-managemen [...]
+</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="215.2" textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-8)">google</text><text
class="breeze-release-management-publish-docs-r1" x="85.4" y="215.2"
textLength="36.6"
clip-path="url(#breeze-release-management-publish-docs-line-8)"> | </text><text
class="breeze-release-management-publish-docs-r4" x="122" y="215.2"
textLength="48.8" clip-path="url(#breeze-release-management-publ [...]
+</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="239.6" textLength="109.8"
clip-path="url(#breeze-release-management-publish-docs-line-9)">microsoft</text><text
class="breeze-release-management-publish-docs-r1" x="122" y="239.6"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-9)">.</text><text
class="breeze-release-management-publish-docs-r4" x="134.2" y="239.6"
textLength="48.8" clip-path="url(#breeze-release-management-publish-doc [...]
+</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="264" textLength="73.2"
clip-path="url(#breeze-release-management-publish-docs-line-10)">oracle</text><text
class="breeze-release-management-publish-docs-r1" x="85.4" y="264"
textLength="36.6"
clip-path="url(#breeze-release-management-publish-docs-line-10)"> | </text><text
class="breeze-release-management-publish-docs-r4" x="122" y="264"
textLength="109.8" clip-path="url(#breeze-release-management-publish [...]
+</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="288.4" textLength="134.2"
clip-path="url(#breeze-release-management-publish-docs-line-11)">singularity</text><text
class="breeze-release-management-publish-docs-r1" x="146.4" y="288.4"
textLength="36.6"
clip-path="url(#breeze-release-management-publish-docs-line-11)"> | </text><text
class="breeze-release-management-publish-docs-r4" x="183" y="288.4"
textLength="61" clip-path="url(#breeze-release-manageme [...]
+</text><text class="breeze-release-management-publish-docs-r4" x="12.2"
y="312.8" textLength="85.4"
clip-path="url(#breeze-release-management-publish-docs-line-12)">zendesk</text><text
class="breeze-release-management-publish-docs-r1" x="97.6" y="312.8"
textLength="1354.2"
clip-path="url(#breeze-release-management-publish-docs-line-12)">]...                         
[...]
</text><text class="breeze-release-management-publish-docs-r1" x="1464"
y="337.2" textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-13)">
</text><text class="breeze-release-management-publish-docs-r1" x="12.2"
y="361.6" textLength="707.6"
clip-path="url(#breeze-release-management-publish-docs-line-14)">Command to publish generated documentation to airflow-site</text><text
class="breeze-release-management-publish-docs-r1" x="1464" y="361.6"
textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-14)">
</text><text class="breeze-release-management-publish-docs-r1" x="1464"
y="386" textLength="12.2"
clip-path="url(#breeze-release-management-publish-docs-line-15)">