[clubanderson]

Closes #12439

What changed

src/pkg/dashboard/static/index.html — #faq-section / #faq-panel:

Audited against today's v5 docs/code — rewritten

• What do L3–L6 allow? — the L6 bullet claimed a requires_human/reject verdict "pulls a PR out of the auto-merge lane". Per acmm-policy-matrix.md and running-at-level-6.md#does-the-hive-reviewer-stop-a-merge, the App auto-merge sweep does not read reviewer verdicts; the answer now says so and points at hold / branch rules. Also notes adjudicator/dedupe recommend only.
• How do I move from L2 to L3? — names the level chip in the top bar as the dialog.
• Advisory Digest / colors / ordering — trimmed, "bead" defined on first use, links to dashboard-sections.md#advisory-digest.
• Timezone — now links its source (settings.md).
• Spend / cadence / first day / where did the money go — kept; the "cadence vs run length" paragraph became its own question; the cost answer links dashboard-sections.md#cost; dropped the unsourced quota-publisher aside.
• Footprint — the attribution-trailer sentence moved to its own question; links github-write-surface.md.
• Two contributor-relay.md#run-stage-assignments-… anchors pointed at a heading that does not exist; now link the page.

Removed: nothing wholesale — every prior topic survives, but duplicated prose was folded into the questions above.

Added (each ≤ 4 sentences, one or more doc links, verified against code/docs)

• What is the Evidence card and what do its charts prove (review-evidence.md#how-to-read-the-evidence-card; 24h/7d/30d/custom pills, ⓘ explainers, grades, "never read by anything that decides a merge")
• Why "N behind" measures against my channel, not v4 head (release-channels.md#channel-aware-upgrade-targeting, upgradeTargetLabel Update status is inconsistent on edge spokes: Hub tab measures against v4, top bar shows wrong distance, hub says 'running target' for a stale SHA #7262)
• What are release channels / how does an upgrade happen (release-channels.md, stable-soak-policy.md)
• Why did a PR get a hold label / what is hold-gated (labels-and-control-signals.md: level gate, 🐛 bug: an agent files an issue proposing a direction, then implements it with no human sign-off #5117, ✨ [v5] Reporter-trust gating: maintainer issues work unlabelled, external reporters need triage and never auto-merge #9665, SHA-hold)
• What is shadow mode; does it ever block a merge — no (review-swarm.md#configuration, intent-verification.md#shadow-mode; toggles in Settings → Features → Review Gate and Settings → Security)
• What is a Model Gateway / can I use OpenRouter instead of a CLI login (agent-configuration.md#methods-subscription-clis-vs-self-hosted-inference, docs/inference-backends.md)
• What is the Experiment Lab (repo-only since 🌱 experiment lab: repo-only — drop governor scope selector #12207, L4+, dashboard.experiment_lab; strategy-lab.md)
• What does the attribution trailer do (hive-open-pr.md#the-opened-pr-carries-an-attribution-trailer; governor.attribution_trailer default on, audit entry always)
• Why can't I see a section / how do I reorder or hide sections (dashboard.md#reorder-sections)
• Where is the audit log and who owns an action (audit-log.md, dashboard-sections.md#audit-log)
• How do I pause the hive / stop one agent (agent ⏸, repo pause, fleet breaker; operator-reference.md#fleet-breaker, repo-pause.md, running-at-level-6.md#stops-smallest-to-largest)
• On a phone, where is the profile menu (🐛 dashboard: profile menu does not open on mobile navbar #12193)

Structure

• Seven <section class="faq-group"> with <h3 class="faq-group-title">; every question is <details class="faq-q" id="faq-…"><summary>…</summary>…</details>.
• #faq-filter ("Filter questions…", data-input-action="faqFilter") hides non-matching <details>, hides emptied groups, opens matches, shows "N of M" and a #faq-empty note.
• "Was this answered?" footer → Discord / in-dashboard feedback form / open an issue.
• renderFAQ() collapsed summary now shows "N questions".
• id="faq-section" and data-dashboard-section unchanged; layout/reorder/collapse tests untouched.

Style ratchet: all inline style= in the panel moved to token-based .faq-* classes. webstatic/style_ratchet_test.go baselines lowered (never raised): inlineStyles 1491→1432, rawFontSizes 630→603, rawBorderRadii 175→174.

Tests: new pkg/dashboard/faq_ui_test.go — section ids, filter input, every .faq-q has exactly one <summary>, every answer has an href, no inline styles in #faq-panel, no <details> without faq-q, stale-claim guard. Existing TestFAQConfigKeysExistInSchema still passes (all <code>dotted.keys</code> exist in config.Config).

Docs: dashboard-sections.md FAQ entry rewritten (first sentence == DASHBOARD_SECTION_HELP help text, ≤ 25 words); dashboard.md FAQ paragraph updated; nav title on the FAQ sidebar row updated. Changelog fragment changelog.d/changed-dashboard-faq-refresh.md.

Nothing here reads into or alters merge eligibility / auto-merge (RFC #12062 non-goals): the FAQ is static text plus a client-side filter.

cc @mrbobbytables

[kubestellar-prow]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign nicholasjackson for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[github-actions]

Open PR overlap check

Base branch: v5

Conflicts are checked with every PR merged onto the current tip of v5, so a PR that only needs a rebase is not reported as conflicting with its siblings.

PR	Title	Relation	Files
#12388	✨ dashboard: Evidence panel 4 — boundary enforcement (attempted vs blocked writes per tier; sentinel hits/week)	same files	src/pkg/dashboard/static/index.html
#12415	✨ feat(dashboard): add evidence maintainability trend panel	same files	src/pkg/dashboard/static/index.html
#12332	✨ feature: Add cadence templates for quickly setting cadence for all agents (#12300)	same files	src/pkg/dashboard/static/index.html
#12434	✨ labels: stage/N state-machine labels for issues and PRs	same files	src/pkg/dashboard/static/index.html

[hivecommons-hive]

merged by Hive trusted-author auto-merge: author @clubanderson holds role owner and GitHub permission admin on repo; CI green at 92c347a.

[github-actions]

Thank you for your contribution! Your PR has been merged.

We'd love to hear how your experience was: share feedback