You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Documentation for Human-in-the-loop operator #52206
@Jasperora#52868 has now been merged, giving us a clearer understanding of its potential uses. Please take a moment to browse the PR and familiarize yourself with it. The description in the PR will help you comprehend its purpose, along with the example provided in the description #52868 (comment).
You DO NOT need to understand all the details of it but how to use it.
I expect I'll do some of the documentation work in #52207.
cc @jason810496 since I've shared this in the last airflow meetup, it would be nice if you could kindly take a look and help @guan404ming and @Jasperora . Thanks a lots!
Hi @Lee-W, I'm planning to add the documentation in airflow-core/docs/tutorial folder.
Besides, I'm considering adding markers such as# [START howto_hitl_branch_operator] in providers/standard/src/airflow/providers/standard/example_dags/example_hitl_operator.py. to help with the documentation.
Would you recommend doing so?
I'd appreciate your advice before proceeding. Thanks!
The #53694 provides a good illustration on how to use these operators. We can merge this first. After #53035 is also merged, we'll work on the doc for UI part. Then I think we can close this issue. Thanks @Jasperora !
Hey @Jasperora, as #53035 has merged, would you like to create a new PR for more detailed usage? 🙂 In #54128, I also added a few examples. Might be helpful as well
Activity
[-]Documentation for Human-in-the-loope operators[/-][+]Documentation for Human-in-the-loope operator[/+]Jasperora commentedon Jun 29, 2025
I am interested in this feature. May I help with it?
Lee-W commentedon Jun 29, 2025
Sure thing :)
[-]Documentation for Human-in-the-loope operator[/-][+]Documentation for Human-in-the-loop operator[/+]Lee-W commentedon Jul 11, 2025
@Jasperora #52868 has now been merged, giving us a clearer understanding of its potential uses. Please take a moment to browse the PR and familiarize yourself with it. The description in the PR will help you comprehend its purpose, along with the example provided in the description #52868 (comment).
You DO NOT need to understand all the details of it but how to use it.
I expect I'll do some of the documentation work in #52207.
However, mine won't address the UI aspect (#52094). It would be great if you could collaborate with @guan404ming to explore ways to help users easily understand what this is, how to use it, and the benefits they can gain from it. I believe the paragraph in https://cwiki.apache.org/confluence/display/AIRFLOW/AIP-90+Human+in+the+loop would also be quite helpful.
cc @jason810496 since I've shared this in the last airflow meetup, it would be nice if you could kindly take a look and help @guan404ming and @Jasperora . Thanks a lots!
Jasperora commentedon Jul 22, 2025
Hi @Lee-W, I'm planning to add the documentation in
airflow-core/docs/tutorialfolder.Besides, I'm considering adding markers such as
# [START howto_hitl_branch_operator]inproviders/standard/src/airflow/providers/standard/example_dags/example_hitl_operator.py.to help with the documentation.Would you recommend doing so?
I'd appreciate your advice before proceeding. Thanks!
Lee-W commentedon Jul 22, 2025
Sounds awesome
Jasperora commentedon Jul 24, 2025
Hi @Lee-W, I created a draft PR to introduce HITL through the example. I'll collaborate with @guan404ming to add UI part doc into it.
Lee-W commentedon Jul 29, 2025
The #53694 provides a good illustration on how to use these operators. We can merge this first. After #53035 is also merged, we'll work on the doc for UI part. Then I think we can close this issue. Thanks @Jasperora !
Lee-W commentedon Aug 5, 2025
Hey @Jasperora, as #53035 has merged, would you like to create a new PR for more detailed usage? 🙂 In #54128, I also added a few examples. Might be helpful as well
Jasperora commentedon Aug 5, 2025
Sure!
phanikumv commentedon Aug 18, 2025
Waiting for the shared links functionality to be merged, so that we can start on this ticket.