potiuk commented on PR #46056: URL: https://github.com/apache/airflow/pull/46056#issuecomment-2615241700
Is there a way we can easily get to update that picture when it changes in the future ? I am a big fan of generating such images from text / code rather than drawing them by hand. We even already have a number of such images generated from the code via pre-commit - using the cool `diagrams` library: Python file: https://github.com/apache/airflow/blob/main/docs/apache-airflow/img/diagram_basic_airflow_architecture.py Resulting diagram: https://github.com/apache/airflow/blob/main/docs/apache-airflow/img/diagram_basic_airflow_architecture.png And it's enough to re-run the python file to get the new diagram generated based on it. I somehow don't see a viable path how we can - in the future - easily modify such state diagram if all we have is the .png file or if we need some external tool (what?) to modify the diagram. Yes it might maybe look nicer when generated by hand, but for me long-term maintainabilty is far more important. Otherwise we will have exactly the same situation that we already experienced - where outdated pictures were basically "lying" to our users about someething - where they were supposed to reflect the reality. This is pretty much inevitable, if we have no easy way to regenerate the images with updated changes - and where drawing those by-hand is not really an option. WDYT @pykenny ? Maybe you should try to replicate the diagram using similar approach as our architecture diagrams? -- 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]
