joelsewhere opened a new issue, #65679:
URL: https://github.com/apache/airflow/issues/65679

   ### Description
   
   I propose adding a `doc_md` attribute to task groups that renders the 
documentation in the details sections for the group. The task group details 
section is pretty lacking in information right now, and high level 
documentation for the group would go a long way.
   
   ### Use case/motivation
   
   I have non technical stakeholders who are interested in understanding dags 
at a high level, and task groups work great for generating a dag visualization 
that can behave as user friendly documentation. I would like to provide written 
summaries to stakeholders about each operation, but am only able to do this at 
the task level. The task level is too detailed for non technical stakeholders, 
and requires drilling down into the task group, which can easily overwhelm 
users who're unfamiliar with data engineering terminology/operations. 
   
   ### Related issues
   
   _No response_
   
   ### Are you willing to submit a PR?
   
   - [ ] Yes I am willing to submit a PR!
   
   ### Code of Conduct
   
   - [x] I agree to follow this project's [Code of 
Conduct](https://github.com/apache/airflow/blob/main/CODE_OF_CONDUCT.md)
   


-- 
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]

Reply via email to