shahar1 opened a new pull request, #74169: URL: https://github.com/apache/airflow/pull/74169
related: #74151 related: #74168 <details><summary>AI Summary</summary> Moving the docs build to Python 3.11 (#74151) moves it from Sphinx 8.1.3 to Sphinx 9.0.4, which resolves annotation and field types project-wide. That turns a few long-standing docstring mistakes into ambiguous or broken references that fail the docs and spellcheck jobs: - **google `vertex_ai/auto_ml.py`**: `:param budget_milli_node_hours (int):` is not a valid field; Sphinx read `budget_milli_node_hours` as a type name and matched the operators' attributes of that name. - **google `compute.py`**: three methods documented `:rtype: object` although their signatures already return `InstanceTemplate`, `Instance` and `InstanceGroupManager`; the field is removed so the real annotation is rendered. The two class names are added to the spelling wordlist next to the other Compute class names. - **amazon `executors/batch/utils.py`**: `CommandType` and the alias target `WorkloadKey` matched the same-named aliases in the ECS and Lambda executors. `CommandType` is now annotated as a `TypeAlias` like theirs (so it resolves in its own module), and the core `WorkloadKey` is imported as `_WorkloadKey`, the pattern the Lambda executor already uses. - **task-sdk `deferred-vs-async-operators.rst`**: `:doc:` used an `airflow:` inventory prefix that does not exist; every other cross-package link uses `apache-airflow:`. The builtin `type`/`object` warnings are an upstream Sphinx regression and are handled in #74168. Checks run: with both PRs applied, `--docs-only` for amazon, google, openlineage and task-sdk passes on Python 3.11 / Sphinx 9.0.4, and google spellcheck passes; Breeze mypy on the changed amazon and google modules passes on Python 3.11. </details> --- ##### Was generative AI tooling used to co-author this PR? - [X] Yes — Claude Code (Opus 5.5) Generated-by: Claude Code (Opus 5.5) following [the guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#gen-ai-assisted-contributions) 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01SkLWWaTT1cnFqTT1jhFGxe -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
