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 autoapI.
Previously example dags were excluded by `*/example_dags/*` and that's why
it was not needed but witt the latest sphinx update - but 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]
