Skip to content

[deep-report] [quick-win] Document 3 undocumented top-level frontmatter fields + fix broken in-schema anchors #36275

Description

@github-actions

Problem

Schema Consistency Check (#36193, findings #5 & #6) found three top-level frontmatter fields with zero mentions in any curated doc, and two of them link to non-existent doc anchors:

  • check-for-updates — 0 hits in docs/src/content/docs/reference/frontmatter.md; schema description links to reference/frontmatter/#check-for-updates which has no matching heading.
  • disable-model-invocation — 0 doc mentions.
  • run-install-scripts — 0 doc mentions; schema description links to reference/frontmatter/#run-install-scripts with no matching heading.

(Auto-generated frontmatter-full.md excluded — it doesn't count as curated docs.)

Suggested fix

Add a short section/heading for each field in docs/src/content/docs/reference/frontmatter.md (or the appropriate sibling reference page) so the in-schema anchor links resolve, OR correct the schema descriptions to point at valid anchors.

Success criteria

  • Each of the 3 fields has a curated doc entry.
  • The #check-for-updates and #run-install-scripts schema anchor links resolve to real headings.

Effort

~1 h. Suggested agent: docs-updater.

Source: DeepReport 2026-06-01, findings #5/#6 of #36193.

Generated by 🔬 DeepReport - Intelligence Gathering Agent · opus48 1.6M · ◷

  • expires on Jun 3, 2026, 4:41 PM UTC

Activity

  1. github-actions commented on Jun 1, 2026

    @github-actions
    ContributorAuthor

    🍪 Issue Monster selected this for Copilot

    I've identified this issue as a good candidate for automated resolution and requested assignment to the Copilot coding agent.

    If assignment succeeds, the Copilot coding agent will analyze the issue and create a pull request with the fix.

    Om nom nom! 🍪

    🍪 Om nom nom by Issue Monster · haiku45 25.2K · ◷

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions