Skip to content

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

@github-actions

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

Metadata

Metadata

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions