mik-laj commented on issue #8119: URL: https://github.com/apache/airflow/issues/8119#issuecomment-649466726
Does anyone have any opinions about other tools? I have heard positive reviews about Redoc. What could the integration of Sphinx with Redoc look like? I have the idea that when publishing documentation on airflow.apache.org we can copy HTML files from redoc-cli to the _build directory. For publication on airflow.readthedocs.org, we can replace use other service to render docs. Here is a preview of these two tools. Swaagger UI: https://editor.swagger.io/?url=https://raw.githubusercontent.com/apache/airflow/master/airflow/api_connexion/openapi/v1.yaml Redoc: https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/apache/airflow/master/airflow/api_connexion/openapi/v1.yaml ---------------------------------------------------------------- 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. For queries about this service, please contact Infrastructure at: [email protected]
