potiuk commented on code in PR #24386:
URL: https://github.com/apache/airflow/pull/24386#discussion_r895506685
##########
docs/apache-airflow-providers-apache-cassandra/index.rst:
##########
@@ -33,6 +33,7 @@ Content
:caption: References
Python API <_api/airflow/providers/apache/cassandra/index>
+ System Tests <_api/tests/system/providers/apache/cassandra/index>
Review Comment:
Yes I also thought we might not need that. It's Mainly there add it to any
toc tree- if we don't do it, sphinx complains that the index is missing from
the toc tree. Do you know how to exclude those links in general? I am happy to
remove them, but I simply have no idea how. Likely some exclude somewhere in
sphinx config.
Previously example dags were excluded by `*/example_dags/*` and that's why
it was not needed but with the latest sphinx update it caused hte problem of
missing examples. We cannot exclude them this way because then they will be
removed from the generated html (that was precisely the root cause of missing
links previously - the "missing index in toc tree" was not generated but also
link to example dags led to 404 because the generated example_dags pages were
missing.
So if we know a better way to keep the files but not to have them included
in any toc tree - that would be awesome. But I do no know how to do it.
--
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]
