kyungjunleeme opened a new pull request, #73398: URL: https://github.com/apache/airflow/pull/73398
`authoring-and-scheduling/cron.rst` is where users land when they ask "when does my cron Dag run?". It documents cron syntax thoroughly — expressions, presets, croniter extensions, crontab.guru — but never states **when the scheduler actually creates the run** relative to `logical_date`. That is the one thing that changed in Airflow 3, and the page named after cron is silent about it. In Airflow 3 `[scheduler] create_cron_data_intervals` defaults to `False`, so a bare cron string resolves to `CronTriggerTimetable` rather than `CronDataIntervalTimetable`. The information exists, but only on `timetable.rst` and `core-concepts/dag-run.rst`, and neither was linked from `cron.rst`. This adds a short "When does a cron schedule fire?" section covering both timetable kinds, how to pin one explicitly for a single Dag, and `seealso` links to the config option and the two pages that carry the detail. Docs-only change; no newsfragment (not a user-facing behaviour change). --- ##### Was generative AI tooling used to co-author this PR? - [X] Yes — Claude Code (Opus 5) Generated-by: Claude Code (Opus 5) following [the guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#gen-ai-assisted-contributions) -- 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]
