bnspopi opened a new pull request, #74598:
URL: https://github.com/apache/airflow/pull/74598
The variables table in the templates reference links `DagRun`, `DAG`,
`BaseOperator` and `TaskInstance` to `airflow.models.*` classes. Those modules
are not part of the documented API in Airflow 3, so the links render as plain
text and nothing is clickable. That is what #60477 reports.
This points them at the public Task SDK objects instead:
- `{{ dag }}` -> `airflow.sdk.DAG`
- `{{ task }}` -> `airflow.sdk.BaseOperator`
- `{{ task_instance }}` / `{{ ti }}` ->
`airflow.sdk.types.RuntimeTaskInstanceProtocol`, shown as "TaskInstance"
- `{{ dag_run }}` and the other Dag run references ->
`airflow.sdk.types.DagRunProtocol`, shown as "DagRun"
These are the same targets the public interface page already uses, so they
resolve. `AssetEvent` has no public class to link to, so it is shown as code.
`random.random` is a function, so it now uses `:func:`.
Two earlier PRs for this issue (#60507 and #71562) went stale after
approval; this follows the same idea with targets that exist in the current
docs.
closes: #60477
---
##### Was generative AI tooling used to co-author this PR?
- [X] Yes (Claude Code)
Generated-by: Claude Code following [the
guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#gen-ai-assisted-contributions)
---
* Read the **[Pull Request
Guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#pull-request-guidelines)**
for more information. Note: commit author/co-author name and email in commits
become permanently public when merged.
* For fundamental code changes, an Airflow Improvement Proposal
([AIP](https://cwiki.apache.org/confluence/display/AIRFLOW/Airflow+Improvement+Proposals))
is needed.
* When adding dependency, check compliance with the [ASF 3rd Party License
Policy](https://www.apache.org/legal/resolved.html#category-x).
* For significant user-facing changes create newsfragment:
`{pr_number}.significant.rst`, in
[airflow-core/newsfragments](https://github.com/apache/airflow/tree/main/airflow-core/newsfragments).
You can add this file in a follow-up commit after the PR is created so you
know the PR number.
--
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]
