Skip to content

docs: correct repeat spec hash key name in site docs#151

Merged
jotarios merged 1 commit into
mainfrom
docs/fix-repeat-spec-key-name
Jun 26, 2026
Merged

docs: correct repeat spec hash key name in site docs#151
jotarios merged 1 commit into
mainfrom
docs/fix-repeat-spec-key-name

Conversation

@jotarios

Copy link
Copy Markdown
Owner

What

Corrects the repeatable-spec Redis key name in three live docs-site pages.

The scheduler/concepts pages described the spec storage as a single {chasqui:<queue>}:repeat:specs hash "mapping spec key → encoded spec". The engine actually writes one hash per spec at {chasqui:<queue>}:repeat:spec:<key> (singular spec, keyed by the spec key) — see repeat_spec_key in chasquimq/src/redis/keys.rs:58.

Why

The :repeat:specs (single-hash) wording is left over from the original Phase-3 design and was never how the shipped engine works. The reference docs (reference/wire-format.md, concepts/redis-cluster.md) and engine docs already used the correct :repeat:spec:<key> form, so the three pages fixed here were the only stale surfaces. This corrects both the key name and the inaccurate "single hash mapping key → spec" framing.

Files

  • site/src/content/docs/guides/schedule-repeatable-jobs.mdx
  • site/src/content/docs/concepts/the-scheduler.md
  • site/src/content/docs/concepts/thinking-in-chasquimq.mdx (2 occurrences)

docs/phase3-napi-design.md is intentionally left unchanged — it is a frozen historical design artifact describing the planned design, not current behavior.

Docs-only, no code or behavior change.

The scheduler/concepts pages described the repeatable-spec storage as a
single `{chasqui:<queue>}:repeat:specs` hash mapping spec key to spec.
The engine actually writes one hash per spec at
`{chasqui:<queue>}:repeat:spec:<key>` (see repeat_spec_key in
chasquimq/src/redis/keys.rs). Correct the key name and the
single-hash framing across the three live site pages to match the engine
and the reference/wire-format + redis-cluster docs, which were already
correct.
@jotarios jotarios merged commit 9931d99 into main Jun 26, 2026
11 checks passed
@jotarios jotarios deleted the docs/fix-repeat-spec-key-name branch June 26, 2026 15:22
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