Skip to content

[deep-report] Docs quick-wins: duplicate CLI heading text + home page Mermaid diagram has no fallback description #56854

Description

@github-actions

Problem

Two small, independently-verified docs quick-wins from this cycle's documentation review:

1. Duplicate heading text on the CLI Commands page

docs/src/content/docs/setup/cli.md has the same heading text appearing twice in close proximity:

  • Line 81: <summary><strong>Advanced: GitHub Enterprise Server Support</strong>
  • Line 83: ### GitHub Enterprise Server Support

This reads as a copy/paste duplication rather than intentional structure (a collapsible summary label immediately followed by a heading with nearly identical text).

2. Home page Mermaid diagram has no documented fallback

docs/src/content/docs/index.mdx:64-65 renders a diagram via a raw ```mermaid code fence in the "Guardrails Built-In" section. If client-side JS/Mermaid rendering fails to hydrate (e.g. JS disabled, network issue loading the renderer), a first-time visitor sees a raw, unstyled code block instead of a diagram, with no fallback description of what it depicts.

Evidence

Both verified live in the current repo. Source: Documentation Noob Test Report discussion #56821, "Confusing Areas" items 2 and 4.

Suggested action

  • Reword the <summary> label or the heading in cli.md so they aren't near-duplicates (e.g. summary could read "Advanced Configuration" or similar).
  • Add brief alt-text-style prose near the home page Mermaid diagram summarizing what it shows, so the content isn't lost if rendering fails.

Acceptance criteria

  • cli.md summary/heading pair no longer duplicate text.
  • Home page Mermaid diagram section has a one-line text description of its content independent of whether Mermaid renders.

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • api.anthropic.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "api.anthropic.com"

See 网络 Configuration for more information.

Generated by 🔬 Deep Report · claude · agent · 258.7 AIC · ⌖ 8.26 AIC · ⊞ 12.4K ·

  • expires on Aug 30, 2026, 10:49 PM UTC-08:00

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    项目

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions