Description
The schema consistency check found that docs/src/content/docs/reference/frontmatter-full.md still contains a prominent dedicated deprecated-alias block for dispatch_repository (underscore form), making the old form easy to copy forward. The compiler already warns to rename it, but the docs lag behind.
Suggested Changes
- In
docs/src/content/docs/reference/frontmatter-full.md, demote the dispatch_repository deprecated alias block:
- Move any canonical
dispatch-repository (kebab-case) examples before the deprecated alias mention
- Convert the deprecated alias block into a narrow migration note (e.g., a callout/warning box)
- Ensure docs clearly guide users toward
safe-outputs.dispatch-repository (kebab-case) as the canonical form
Files Affected
docs/src/content/docs/reference/frontmatter-full.md
Success Criteria
dispatch-repository (canonical kebab-case) example appears before deprecated alias mention
- Deprecated alias is in a migration/warning callout, not a prominent standalone block
- No broken links or references
Source
Extracted from Schema Consistency Check - 2026-07-27. Finding 2: frontmatter-full.md still contains a dedicated deprecated alias block for dispatch_repository, which makes the old form easy to copy forward.
Priority
Medium — Reduces future author confusion and deprecated-config proliferation. Estimated effort: 30–60 minutes.
🔍 Task mining by Discussion Task Miner - Code Quality Improvement Agent · sonnet46 · 55.3 AIC · ⌖ 5.38 AIC · ⊞ 7.2K · ◷
Description
The schema consistency check found that
docs/src/content/docs/reference/frontmatter-full.mdstill contains a prominent dedicated deprecated-alias block fordispatch_repository(underscore form), making the old form easy to copy forward. The compiler already warns to rename it, but the docs lag behind.Suggested Changes
docs/src/content/docs/reference/frontmatter-full.md, demote thedispatch_repositorydeprecated alias block:dispatch-repository(kebab-case) examples before the deprecated alias mentionsafe-outputs.dispatch-repository(kebab-case) as the canonical formFiles Affected
docs/src/content/docs/reference/frontmatter-full.mdSuccess Criteria
dispatch-repository(canonical kebab-case) example appears before deprecated alias mentionSource
Extracted from Schema Consistency Check - 2026-07-27. Finding 2:
frontmatter-full.mdstill contains a dedicated deprecated alias block fordispatch_repository, which makes the old form easy to copy forward.Priority
Medium — Reduces future author confusion and deprecated-config proliferation. Estimated effort: 30–60 minutes.