Skip to content

docs: fix cron examples that put the seconds field first - #48

Merged
rnv812 merged 1 commit into
developfrom
fix/cron-examples
Jul 25, 2026
Merged

docs: fix cron examples that put the seconds field first#48
rnv812 merged 1 commit into
developfrom
fix/cron-examples

Conversation

@rnv812

@rnv812 rnv812 commented Jul 25, 2026

Copy link
Copy Markdown
Member

Fixes eventum-generator/eventum#187.

Ten examples were written as if a cron expression took seconds as its first field. The generator takes them after the weekday, so each one ran a different schedule than its comment claimed. Every replacement below was checked against croniter, the parser the cron input plugin uses.

Page Was Now Behaviour restored
core/concepts/scheduling.mdx * * 9-17 * * MON-FRI * 9-17 * * MON-FRI * Was rejected by croniter outright; now every second, 09:00-17:59, weekdays
core/concepts/scheduling.mdx 0 */5 * * * * */5 * * * * 0 50-event burst at second 0 of every 5th minute, not 50 per second for a minute every 5 hours
core/concepts/scheduling.mdx */10 * 0-8,18-23 * * * * 0-8,18-23 * * * */10 Every 10 seconds during off-hours, not every second on days 1-8 and 18-23 of the month
core/concepts/plugins.mdx */5 * * * * * * * * * * */5 Heartbeat every 5 seconds
core/concepts/plugins.mdx 0 * * * * * * * * * * Once a minute, not 60 events in the first minute of every hour
core/config/generator-yml.mdx */10 * * * * * * * * * * */10 Error stream every 10 seconds
core/introduction/features.mdx */5 * * * * * * * * * * */5 Every 5 seconds
plugins/event/replay.mdx */5 * * * * * * * * * * */5 Matches its own # every 5 seconds comment
plugins/event/script.mdx */5 * * * * * * * * * * */5 regular tick every 5 seconds
plugins/event/script.mdx */2 * * * * * * * * * * */2 Matches its own # a request every 2 seconds comment

tutorials/telegram-alerts.mdx carries the same mistake on develop but is left alone here: the learning-course branch (#45) has a newer version of that page and already fixes it in 6e5cacb.

Only the expressions changed - comments and prose around them were already describing the intended schedule, and they now match. * * * * * * examples elsewhere in the docs mean "every second" under either reading and needed no change; content-pack generators use only that form.

pnpm build passes.

Follows #46, which corrected the field-order table in the cron reference.

Ten examples across the concepts, config and plugin pages were written
as if a cron expression took seconds as its first field. The generator
takes them after the weekday, so each ran a different schedule than its
comment claimed - "every 5 seconds" fired every second during minutes
divisible by 5, the 50-event burst landed once every 5 hours, and the
business-hours example was rejected outright. Rewrite them in the
engine's order.

Refs eventum-generator/eventum#187

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant