dstandish commented on code in PR #29200: URL: https://github.com/apache/airflow/pull/29200#discussion_r1090965039
########## docs/apache-airflow/public-airflow-interface.rst: ########## @@ -245,24 +245,17 @@ Executors are the mechanism by which task instances get run. All executors are derived from :class:`~airflow.executors.base_executor.BaseExecutor`. There are several executor implementations built-in Airflow, each with its own unique characteristics and capabilities. -Airflow has a set of Executors that are considered public. You are free to extend their functionality -by extending them: - -.. toctree:: - :includehidden: - :glob: - :maxdepth: 1 - - _api/airflow/executors/index Review Comment: Confused, do we not want the executor docs autogenerated? I know we have every executor documented in core-concepts. But, if we tell auto-api to skip it, will the autogen documentation not be rendered at all? I.e. maybe this page will not be generated https://airflow.apache.org/docs/apache-airflow/stable/_api/airflow/executors/index.html ? Is that desirable? -- 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]
