mik-laj opened a new pull request #12444: URL: https://github.com/apache/airflow/pull/12444
Part of: https://github.com/apache/airflow/issues/11423 In this PR I made the following changes: - I split the documentation generation process for each package separately. Now we are not building one documentation for the entire Airflow, but we are building documentation for the core and for each provider separately. - The documentation for the Python API for each provider has been migrated to the provider's documentation. - For apache-airflow-providers-googoe all (almost all documentation) was migrated. - An extension has been prepared, which facilitates the creation of links between documents i.e. if you write `:class: airlfow.providers......` anywhere in the documentation a working link to the documentation in a good package will be generated. - RTD is not enough anymore, so documentation is built on CI / CD and published on S3. Preview: http://apache-airflow-docs.s3-website.eu-central-1.amazonaws.com/ In this PR, I would like to do a few more things: - clean-up code - add documentation on building documentation In next PRs, I will deal with the following things: - The documentation will use the official Apache Airflow theme - Improve the process of publishing the documentation on airflow-site - migrate the content of the documentation to the provider documentations - move the core documentation to the apache-airflow directory. <!-- Thank you for contributing! Please make sure that your code changes are covered with tests. And in case of new features or big changes remember to adjust the documentation. Feel free to ping committers for the review! In case of existing issue, reference it using one of the following: closes: #ISSUE related: #ISSUE How to write a good git commit message: http://chris.beams.io/posts/git-commit/ --> --- **^ Add meaningful description above** Read the **[Pull Request Guidelines](https://github.com/apache/airflow/blob/master/CONTRIBUTING.rst#pull-request-guidelines)** for more information. In case of fundamental code change, Airflow Improvement Proposal ([AIP](https://cwiki.apache.org/confluence/display/AIRFLOW/Airflow+Improvements+Proposals)) is needed. In case of a new dependency, check compliance with the [ASF 3rd Party License Policy](https://www.apache.org/legal/resolved.html#category-x). In case of backwards incompatible changes please leave a note in [UPDATING.md](https://github.com/apache/airflow/blob/master/UPDATING.md). ---------------------------------------------------------------- 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]
