This is an automated email from the ASF dual-hosted git repository.
shahar1 pushed a commit to branch v3-2-test
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/v3-2-test by this push:
new c22c8c454ba [v3-2-test] Exclude auto-generated REST API reference from
docs spell-check (#68114) (#68119)
c22c8c454ba is described below
commit c22c8c454baca308367943cee3bea797062dda71
Author: github-actions[bot]
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Sat Jun 6 10:06:28 2026 +0300
[v3-2-test] Exclude auto-generated REST API reference from docs spell-check
(#68114) (#68119)
The ``stable-rest-api-ref`` page renders the OpenAPI spec via the
``swagger-plugin`` directive. Spell-checking the rendered output flags
machine-generated tokens (camelCase URL path segments, operationIds,
JSON-Schema keywords such as ``oneOf``) as misspellings, which breaks the
docs build whenever new endpoints are added.
Exclude it from spell-check, the same way the other generated pages
(``project.rst``, ``changelog.rst``) already are.
(cherry picked from commit 294467ab1f926175675f31aa7ee4315748f36ab0)
Co-authored-by: Jarek Potiuk <[email protected]>
---
airflow-core/docs/conf.py | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/airflow-core/docs/conf.py b/airflow-core/docs/conf.py
index 71e2b0cd06a..82cced3ea1a 100644
--- a/airflow-core/docs/conf.py
+++ b/airflow-core/docs/conf.py
@@ -350,7 +350,11 @@ redirects_file = "redirects.txt"
# -- Options for sphinxcontrib-spelling
----------------------------------------
spelling_word_list_filename = [SPELLING_WORDLIST_PATH.as_posix()]
-spelling_exclude_patterns = ["project.rst", "changelog.rst"]
+# ``stable-rest-api-ref.rst`` renders the OpenAPI spec via the
``swagger-plugin``
+# directive. Its content is machine-generated (camelCase URL path segments,
+# operationIds, JSON-Schema keywords such as ``oneOf``), not prose, so
spell-checking
+# it only produces false positives that re-break the build on every new
endpoint.
+spelling_exclude_patterns = ["project.rst", "changelog.rst",
"stable-rest-api-ref.rst"]
spelling_ignore_contributor_names = False
spelling_ignore_importable_modules = True
