Links to provider example dags are broken

[jmelot]

Links to provider example dags are broken

[potiuk]

@mik-laj - any idea ?

[potiuk]

Bump?

[mik-laj]

I think we should check this line:
https://github.com/apache/airflow/blob/c5ffe0c2dac14b940b600acaccda3b387ca14a28/docs/conf.py#L234-L236

[potiuk]

I looked at it, but I have no idea what it has to do with it :(

[mik-laj]

I looked at this problem and checked ExampleLiteral directive and it looks fine. However, the problem may be the use of the sphinx.ext.code module which does not make have a simple way to add a new module page and I can see some tricks are being used to integrate the directive with this extension.
Here are source code of sphinx.ext.code extension.
https://github.com/sphinx-doc/sphinx/blob/08a87d945a8ca7770c589ea878e9b095ed35e6d4/sphinx/ext/viewcode.py

[potiuk]

I think we can fix it when we are going to move example dags @mnojek -while implementing https://cwiki.apache.org/confluence/display/AIRFLOW/AIP-47+New+design+of+Airflow+System+Tests ?

[bhirsz]

In linked issue there is similiar problem. All links to source code are dead. Hovewer we can probably track the origin - for example those links are dead:

https://airflow.apache.org/docs/apache-airflow/2.3.0/_modules/airflow/example_dags/example_external_task_marker_dag.html

https://airflow.apache.org/docs/apache-airflow/stable/_modules/airflow/example_dags/example_external_task_marker_dag.html

But this one works:
https://airflow.apache.org/docs/apache-airflow/2.2.3/_modules/airflow/example_dags/example_external_task_marker_dag.html

Something between Airflow 2.2.3 and 2.3.0 caused this issue (for this particular link. We could have dead links for longer period of time).

On side note it would be worth to add very simple ui tests - just parse all links on the site and check if any is 404.

[bhirsz]

It can be used to test links:
https://www.sphinx-doc.org/en/master/usage/builders/index.html#sphinx.builders.linkcheck.CheckExternalLinksBuilder

I can try to do it but only after next few days.

[potiuk]

This is all fixed now.