andrewgodwin opened a new pull request #15444: URL: https://github.com/apache/airflow/pull/15444
This is the first part of me trying to improve Airflow's documentation to make it more consistent and understandable. This takes the old, single-page Concepts document and turns it into a new Concepts section, rewrites some of the text to have consistent terminology (upstream/downstream, Task vs Operator, etc.) and tries to make it generally more accessible and high-level. It also moves a couple of other pages in that directly fit with the existing content (Scheduler and Smart Sensors). Once this is in, I would then like to take on a high-level reorganisation of the other documents, grouping them a bit better (installation/deployment, tutorials, howto) and also making a better overall concept split between "reference" documentation (exhausive, technical details and important notes - not autogenerated API docs) and "concept" documentation (high-level design explanation). A considerable amount of what is currently in "Concepts" should _actually_ be in a "Reference" section, in my view, but I've kept the current grouping for now to make this PR even slightly approachable. -- 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]
