Description
The parser treats safe-outputs.dispatch_repository (snake_case) as a deprecated alias and logs a deprecation warning asking users to rename to dispatch-repository (kebab-case). However, docs/src/content/docs/reference/frontmatter-full.md still documents the deprecated snake_case alias as a first-class surface at lines 9088-9092.
This contradicts the runtime behavior and actively steers users toward a deprecated key, undermining the deprecation effort.
Suggested Changes
- Remove the deprecated
dispatch_repository alias block from frontmatter-full.md
- Replace it with a brief deprecation callout noting that the key was renamed to
dispatch-repository
- Optionally add a doc comment near the parser deprecation warning pointing to the updated docs
Files Affected
docs/src/content/docs/reference/frontmatter-full.md (lines ~9088-9092)
pkg/workflow/dispatch_repository.go (lines 36-41 — the parser deprecation warning, for reference)
Success Criteria
- The deprecated alias is no longer documented as a first-class option
- A brief callout explains the rename for users who search the docs for the old name
- No functional behavior changes
Source
Extracted from [Schema Consistency] Schema Consistency Check - 2026-07-26 #48137
Priority
Medium — actively misleads users toward a deprecated API pattern
🔍 Task mining by Discussion Task Miner - Code Quality Improvement Agent · sonnet46 · 53 AIC · ⌖ 8.39 AIC · ⊞ 7.2K · ◷
Description
The parser treats
safe-outputs.dispatch_repository(snake_case) as a deprecated alias and logs a deprecation warning asking users to rename todispatch-repository(kebab-case). However,docs/src/content/docs/reference/frontmatter-full.mdstill documents the deprecated snake_case alias as a first-class surface at lines 9088-9092.This contradicts the runtime behavior and actively steers users toward a deprecated key, undermining the deprecation effort.
Suggested Changes
dispatch_repositoryalias block fromfrontmatter-full.mddispatch-repositoryFiles Affected
docs/src/content/docs/reference/frontmatter-full.md(lines ~9088-9092)pkg/workflow/dispatch_repository.go(lines 36-41 — the parser deprecation warning, for reference)Success Criteria
Source
Extracted from [Schema Consistency] Schema Consistency Check - 2026-07-26 #48137
Priority
Medium — actively misleads users toward a deprecated API pattern