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

   ### What do you see as an issue?
   
   The constructor snippet shows clearly that there's a keyword parameter 
`use_task_exection_day=False`, but the doc does not explain how to use it. It 
also has `{WeekDay.TUESDAY}, {WeekDay.SATURDAY, WeekDay.SUNDAY}` as options for 
`week_day` but does not clarify how to import WeekDay. The tutorial is also 
very basic and only shows one usecase. The sensor has the same issues.
   
   ### Solving the problem
   
   I think docs should be added for `use_taks_execution_day` and there should 
be mentions of how one uses `WeekDay` class and where to import it from. The 
tutorial is also incomplete there. I would like to see examples for, say, 
multiple different workdays branches and/or some graph for resulting dags
   
   ### Anything else
   
   I feel like BranchDayOfWeekOperator is tragically underrepresented and hard 
to find, and I hope that improving docs would help make its use more common
   
   ### Are you willing to submit PR?
   
   - [X] 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