shahar1 opened a new issue, #74167: URL: https://github.com/apache/airflow/issues/74167
<details><summary>AI Summary</summary> Sphinx 9 (used by the docs build on Python 3.11+) falls back from a `py:class` lookup to a fuzzy `py:data`/`py:attr` search when resolving annotation cross-references. A builtin such as `type` or `object` in an annotation then matches every documented attribute with that name, and the docs build fails with "more than one target found for cross-reference". This is the upstream regression sphinx-doc/sphinx#14223. The docs build works around it with the `python_builtin_xrefs` extension in `devel-common/src/sphinx_exts/`, which skips that fallback for builtin names so they resolve to the Python documentation as in Sphinx 8. **Follow-up:** once sphinx-doc/sphinx#14223 is fixed in every Sphinx version the docs build resolves (9.0.x is the last line for Python 3.11), remove `python_builtin_xrefs.py`, its entry in `BASIC_SPHINX_EXTENSIONS` and its test. **Done when:** the docs build passes on all supported Python versions without the extension. </details> --- Drafted-by: Claude Code (Opus 5.5) (no human review before posting) -- 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]
