Broken Source Code Links in Operator Guides

[SamWheating]

What do you see as an issue?

The [source] links in the operator HowTo guides seem to be 404'ing:

(source)

I tried to fix this but got kinda lost in the docs build system.

Solving the problem

I think that sphinx isn't loading the example_dags folder, as these modules aren't found here:

https://airflow.apache.org/docs/apache-airflow/2.3.0/_modules/

While they were present in 2.2.3:

https://airflow.apache.org/docs/apache-airflow/2.2.3/_modules/

Anything else

I can keep looking into this, but would appreciate any pointers or guidance.

Are you willing to submit PR?

• Yes I am willing to submit a PR!

Code of Conduct

• I agree to follow this project's Code of Conduct

[eladkal]

see #23480

[potiuk]

Yep. Known issue. Maybe time to fix it.

[vijaya-lakshmi-venkatraman]

Hi
I would like to give a try on this if this is not already taken.
Also, request to provide some pointers

[potiuk]

Feel Free! :) Sphinx is a bit mysterious creature and asks many riddles, so any help is more than welcome.

[potiuk]

Some pointers here: apache/airflow-site#536

[potiuk]

And possibly @mik-laj can help

[vijaya-lakshmi-venkatraman]

Thank you.
My understanding from the comment is that between 2.2.3 and the stable (2.3.0) version, the links have stopped working due to some change, possibly in the sphinx.ext.code module.
For the next step, should I be checking how to add a new module to Sphinx?

[potiuk]

I personally do not know :). I have very little knowledge about sphinx. Big part of the task is to find out what to do really because possiblychange in sphinx triggered it but we do not know exactly what was the root cause.

[rbiegacz]

BTW - the links stopped working also for providers. For example, [source] link doesn't work in the page devoted to this operator: https://airflow.apache.org/docs/apache-airflow-providers-google/stable/operators/cloud/automl.html

[potiuk]

Fixes are there:

• Fix links to sources for examples #24386 - fixes it for future documenation (I will cherry-pick it to regeenerate new provider's docs)
• Fix example_dags and system tests "source" links in documentation airflow-site#613 - replaces the missing links in old documentation with lnks to github as we would have to regenerate all teh autapi-generated html pages otherwise as they were missing in the generated docs.