shahar1 commented on issue #61344: URL: https://github.com/apache/airflow/issues/61344#issuecomment-3884359847
> Hi [@shahar1](https://github.com/shahar1) > > I've reviewed AIP-65 and the Astronomer docs you linked. Before I start writing, wanted to quickly confirm the approach: > > My Plan - Comprehensive DAG versioning documentation covering: > > * Introduction (What versioning is and why it matters) > * How it works in the UI (Grid/Graph/Code views with screenshots) > * Execution behavior (clearing, rerunning, mixed versions) > * Common scenarios with examples > * DAG bundles (Local vs Git setup) > * Best practices and troubleshooting > * FAQ page (Optional) > > **Quick questions:** > > 1. Should I add this as a section in [`airflow-core/docs/core-concepts/dags.rst`](https://github.com/apache/airflow/blob/main/airflow-core/docs/core-concepts/dags.rst) or create a separate file like `dag-versioning.rst`? > 2. Any specific scenarios from AIP-65 you definitely want included? > 3. For screenshots - I'll set up Airflow 3 locally to capture real ones, sound good? > > Let me know if this direction works and I'll get started! Your plan sounds solid overall, try to take inspiration from existing pages. Few notes: a. Dag bundles are covered in [this docs page](https://airflow.apache.org/docs/apache-airflow/stable/administration-and-deployment/dag-bundles.html) - try to be focused on the versioning aspect (and you could provide a link to the bundles page when you mention it). b. Regrading the FAQ - there's already [FAQ](https://airflow.apache.org/docs/apache-airflow/stable/faq.html) page, so you could add a section there regarding versioning. Regarding your questions: 1. I think it deserves a page of its own because it's a whole concept, but you should mention it in the Dags.rst page and link from there. 2. I leave it up to you - everything that you find relevant to the user. 3. Sounds great! (please do not copy any assets from Astronomer or non-open source resources 🙂) Please ping me when your PR is ready to be reviewed, of if you get stuck. -- 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]
