fix to fix-templates-doc-broken-links-60477#60507
fix to fix-templates-doc-broken-links-60477#60507Ajay9704 wants to merge 12 commits intoapache:mainfrom
Conversation
|
:class: roles were rendered as inline code inside tables; :py:class: forces proper cross-reference resolution in this context |
|
@Ajay9704, I haven't seen the use of |
sorry for mistake , I thought my pr is in draft mode , but forgot that I changed it , anyways I made changes accordingly by converting to |
|
@kaxil , @jroachgolf84 , @amoghrajesh , @ashb |
@amoghrajesh , @jroachgolf84 whenever you get a moment, please review again. I’ve attached the local build screenshot that is working now. |
|
@Ajay9704 can you rebase and resolve conflicts? |
|
@amoghrajesh @eladkal whenever you get a moment, please review again. I believe the issue is resolved from my end now. |
|
cc @amoghrajesh any further comments? |
Hi @amoghrajesh, Thanks for your feedback. I revalidated this locally and confirmed that there is a difference:
I verified this in the local docs build, and the links are now working as expected. Could you please review again and let me know if anything still needs improvement? Thanks! |



Fix broken links in templates reference documentation
The templates reference page rendered class references (e.g. DagRun, DAG, TaskInstance, BaseOperator, AssetEvent) as inline code instead of clickable links.
The issue was caused by the use of :class: roles inside table contexts, where Sphinx does not reliably resolve cross-references.
This change replaces those references with :py:class: directives, which correctly resolve and render links in tables. The fix restores functional navigation to the relevant API documentation.
Fixes #60477