Skip to content

docs: sync local-source pill docs with the tabbar relocation - #122

Merged
pacphi merged 1 commit into
mainfrom
docs/usage-source-pills-tabbar-sync
Aug 6, 2026
Merged

pacphi merged 1 commit into
mainfrom
docs/usage-source-pills-tabbar-sync

Conversation

@pacphi

@pacphi pacphi commented Aug 6, 2026

Copy link
Copy Markdown
Owner

Summary

#121 relocated the local-source health indicator from text chips inside the Usage panel to branded icon pills in the dashboard's persistent tabbar, but shipped with no doc updates. This closes that gap:

  • USAGE-SCORECARD-METRICS.md — describes the new tabbar placement, branded-icon-over-text-label design, and the icon/status tooltip split.
  • TROUBLESHOOTING.md — "top of the dashboard Usage area" → "the tabbar (top of every view, right-aligned)".
  • ADR-0023 §7 — rewritten for the pill/tabbar design; new paragraph on the icon choice and the size/contrast iteration that got there (two smaller, badge-less passes proved illegible before landing on the Live view's own 32px/20px scale); update note extended; one stray "chip" → "pill" in Consequences.

Test plan

  • pnpm run check (typecheck + lint + markdown lint + build + full test suite) green
  • doc-citations test still passes — no file:line citations moved
  • CI green on this PR

🤖 Generated with Claude Code

#121 relocated the local-source health indicator from text chips inside the
Usage panel to branded icon pills in the dashboard's persistent tabbar, but
shipped with no doc updates — three spots still described the old design
(text chips, "above every Usage view", colored-outline styling), which would
mislead anyone reading them after the fact rather than looking at the code.

* USAGE-SCORECARD-METRICS.md: describes the new tabbar placement, the
  branded-icon-over-text-label design, and the icon-vs-status tooltip split
  (icon hover = what it monitors, status hover = full per-field detail).
* TROUBLESHOOTING.md: "Inspect the local-source chips at the top of the
  dashboard Usage area" -> "Inspect the branded host-icon pills in the
  dashboard's tabbar (top of every view, right-aligned)".
* ADR-0023 §7: rewritten for the pill/tabbar design; added a paragraph
  documenting the icon choice (reused verbatim from the Observability Live
  view's hostIcon()) and the size/contrast iteration that got there — two
  smaller, badge-less passes proved illegible against live screenshots
  before landing on the Live view's own 32px badge/20px glyph scale. Update
  note extended to cover this revision. One stray "chip" -> "pill" in
  Consequences.

Verified: doc-citations test still passes (no file:line citations moved),
markdown lint clean, `pnpm run check` green.
@pacphi
pacphi merged commit 01cccff into main Aug 6, 2026
11 checks passed
@pacphi
pacphi deleted the docs/usage-source-pills-tabbar-sync branch August 6, 2026 09:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant