xBis7 commented on code in PR #53722:
URL: https://github.com/apache/airflow/pull/53722#discussion_r2686669132
##########
devel-common/src/docs/build_docs.py:
##########
@@ -224,6 +224,12 @@ def build_docs_for_packages(
builder = AirflowDocsBuilder(package_name=package_name)
builder.is_autobuild = is_autobuild
builder.clean_files()
+
Review Comment:
I haven't worked with sphinx before. I did some research and it turns out
you are right. A sphinx extension is cleaner and more suitable for this
scenario.
Right before building the docs, we read the yaml and generate a new metrics
table. During the build, the metrics table is there and the `metrics.rst`
successfully includes it.
An extension will handle the process and make sure that the table is always
built and in sync with the yaml during the sphinx startup.
--
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]