kalel-commits commented on code in PR #60149:
URL: https://github.com/apache/airflow/pull/60149#discussion_r2696806837
##########
providers/standard/src/airflow/providers/standard/example_dags/example_branch_operator_decorator.py:
##########
@@ -36,18 +38,59 @@
PATH_TO_PYTHON_BINARY = sys.executable
+
with DAG(
dag_id="example_branch_python_operator_decorator",
start_date=pendulum.datetime(2021, 1, 1, tz="UTC"),
catchup=False,
schedule="@daily",
tags=["example", "example2"],
+ doc_md="""
Review Comment:
Thanks for the suggestion, that’s a nice idea and I agree it would help keep
DAG documentation consistent and co-located with the code.
For this PR, I’ve intentionally kept the documentation inline via doc_md to
align with the existing pattern used in current example and tutorial DAGs. I
wanted to keep the scope limited to addressing the missing Docs tab content
without introducing a broader structural change.
That said, I like the doc_md = __doc__ approach and would be happy to
explore this as a follow-up or incremental PR, especially if there’s interest
in standardizing this pattern across example DAGs. Happy to take guidance on
whether that would be preferred going forward.
--
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]
