Skip to content

[Code Quality] Add deprecated-alias migration note to docs/reference/frontmatter-full.md for dispatch_repository #48384

Description

@github-actions

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 ·

  • expires on Jul 28, 2026, 5:42 AM UTC-08:00

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions