Skip to content

[Code Quality] Remove deprecated dispatch_repository alias from frontmatter-full.md docs #48160

Description

@github-actions

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

  1. Remove the deprecated dispatch_repository alias block from frontmatter-full.md
  2. Replace it with a brief deprecation callout noting that the key was renamed to dispatch-repository
  3. 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 ·

  • expires on Jul 26, 2026, 11:42 PM 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