Skip to content

[Daily Report] Documentation Quality Status Report - 2026-07-20 #46788

Description

@github-actions

Overview

I found 5 open issues that touch documentation quality. Two are already answered in existing docs, one is a clarity/placement gap in Quick Start, one is a true missing-page request, and one is a documentation-policy gap that keeps recurring.

Key Issues

Issue Assessment Relevant docs
#46613 Add Claude OAuth note to quick-start: CLAUDE_CODE_OAUTH_TOKEN unsupported Already answered elsewhere; Quick Start still lacks the note. docs/src/content/docs/reference/auth.mdx:206, docs/src/content/docs/reference/faq.md:368
#46614 Surface --engine claude flag in quick-start prerequisites and add flow Partial gap; Quick Start already shows --engine claude, but not early enough in the flow. docs/src/content/docs/setup/quick-start.mdx:26, docs/src/content/docs/setup/quick-start.mdx:58, docs/src/content/docs/setup/quick-start.mdx:73
#46645 Mark dispatch_repository as deprecated in frontmatter-full.md docs Already answered; the deprecation note is already present. docs/src/content/docs/reference/frontmatter-full.md:8464
#41746 Add SOC-2 compliance patterns doc page True missing-doc request; no SOC-2 patterns page exists yet. Closest coverage: docs/src/content/docs/guides/governance.md:130, docs/src/content/docs/reference/safe-outputs.md:12
#46688 DDUw improvement: record intentional engine-doc exclusions so antigravity drift stops recurring Documentation-policy gap; the catalog exists, but there is no machine-readable exclusion note. docs/src/content/docs/reference/engines.md:3, docs/src/content/docs/reference/model-tables.md:58

Detail

Why these matter
  • #46613 is a duplicate-answer case: CLAUDE_CODE_OAUTH_TOKEN is already documented as unsupported in auth and FAQ, so the issue can likely be closed with a pointer.
  • #46614 is mostly a placement problem. The Quick Start already includes --engine claude, but the default-to-Copilot behavior is only surfaced later.
  • #46645 appears to be stale drift between a schema note and the current full reference. The deprecation callout already exists, so the issue is probably about layout, not missing content.
  • #41746 has no current page to point at. The closest material is governance plus safe-outputs guidance, but not a dedicated compliance-patterns reference.
  • #46688 is not a user-doc gap so much as a documentation governance gap: the engine registry and model table show antigravity, but nothing records the intentional exclusion in a way automation can read.

Next Actions

  • Point #46613 and #46645 reporters to the existing docs instead of duplicating content.
  • Decide whether #46614 should be fixed by moving the note earlier in Quick Start.
  • Add a SOC-2 / compliance-patterns reference page for #41746.
  • Decide whether intentional exclusions like antigravity need a canonical skip-list or docs note for #46688.

Generated by 💻 Dev · 6.51 AIC · ⌖ 2.52 AIC · ⊞ 21K ·
Add label dev to run again

  • expires on Jul 27, 2026, 1:50 AM UTC-08:00

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions