potiuk commented on PR #46694:
URL: https://github.com/apache/airflow/pull/46694#issuecomment-2688995566

   > I dont understand what Sphinx is complaining about: 
`/opt/airflow/docs/apache-airflow-providers-common-messaging/_api/airflow/providers/common/messaging/providers/base_provider/index.rst:
 WARNING: document isn't included in any toctree`
   
   Sphinx is - as usual - speaking riddles :) . It means that there is 
index.rst file generated by autoapi (base_provider module)  and that index is 
not mentioned anywhere. This means that you have to add it to some index file 
and refer to it - because otherwise that file is not reachable from anywhere. 
And it means some documentation is missing to explain what it is - usually a 
reference doc (see in other providers)


-- 
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]

Reply via email to