deepujain opened a new pull request, #64705:
URL: https://github.com/apache/airflow/pull/64705
## Summary
The operators reference listed `GenericTransfer` with a `:mod:` role even
though the entry points to a class path. Because of that mismatch, Sphinx
rendered plain text instead of a clickable link. This switches the entry to
`:class:` so the reference resolves to the provider docs as expected.
## Changes
- **`airflow-core/docs/operators-and-hooks-ref.rst`** -- change the
`GenericTransfer` entry from a module role to a class role.
## Evidence it works
- Before the change, a local Sphinx build rendered the entry as plain code:
`<code class="xref py py-mod
...">airflow.providers.common.sql.operators.generic_transfer.GenericTransfer</code>`
- After the change, the same page rebuilt with a provider-docs link:
`<a class="reference external"
href="/docs/apache-airflow-providers-common-sql/stable/_api/...#airflow.providers.common.sql.operators.generic_transfer.GenericTransfer">...`
- Scoped docs checks passed with:
`prek run --stage pre-commit --files
airflow-core/docs/operators-and-hooks-ref.rst`
## Test plan
- [x] `prek run --stage pre-commit --files
airflow-core/docs/operators-and-hooks-ref.rst`
- [x] Local Sphinx rebuild of `operators-and-hooks-ref.html` confirmed the
`GenericTransfer` entry changes from plain text to a clickable link.
- [ ] CI passes (ruff, mypy, pytest)
Fixes #62470
--
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]
