mpeteuil commented on issue #14969: URL: https://github.com/apache/airflow/issues/14969#issuecomment-805795811
@kaxil I can see what you are saying, but it's still a little confusing. I have always assumed that something like `schedule_interval=timedelta(minutes=5)` would be every 5 minutes using the start date and time as the base from which to start. I think what's confusing about it is that if I provide an hour and minute in the `datetime` object I pass as the `start_date`, then having that get ignored completely is not intuitive. I remember reading in the issues a long time ago something about confusion in needing to line up the cron expression with the `start_date` as well, which is somewhat related. Perhaps the `start_date` was always meant to be just a date and not contain any time at all though. If what you say is the intended behavior, then I think it's worth making that more explicit in the documentation. I don't see anywhere in the docs where this is mentioned. In particular I would have expected to see something about it on one of these pages: https://airflow.apache.org/docs/apache-airflow/stable/tutorial.html https://airflow.apache.org/docs/apache-airflow/stable/concepts.html https://airflow.apache.org/docs/apache-airflow/stable/scheduler.html https://airflow.apache.org/docs/apache-airflow/stable/dag-run.html I don't mind having a go at that, unless you or someone else would like to. Feel free to point me in the right direction of where you think something like that would belong. My initial thought would be scheduler or dag_run docs. -- 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. For queries about this service, please contact Infrastructure at: [email protected]
