0
Fork 0
mirror of https://github.com/zeronsh/comet.git synced 2026-11-16 18:57:19 +00:00
comet/docs/screenshots/icon-tooltips
Alexandre V.L daf047b7fd
Tooltips on the icon-only buttons that had none (#1048)
* Tooltips on the icon-only buttons that had none

The comment "+" in diffs and Markdown previews, and twenty other buttons
that show only a glyph, now say what they do on hover, like the rest of
the app's icon buttons. Each tooltip reuses the button's accessible label
or the wording its twin uses elsewhere.

- Comments: the "+" adder (diffs, Markdown previews, the file editor's
  gutter) and the gutter's comment marker (Show / Hide comment).
- Model picker: the Starred and per-agent tabs, the favorite star, and the
  compact picker's Back.
- Pull requests: Clear search, Send comment.
- Settings: accent swatches, both dialog close buttons, the background
  zoom − / +, the pack stepper, Cloud's repository refresh and code copy,
  and Providers' refresh.
- Shell: the action icon picker, the section dialog's close, the voice
  error's dismiss, and the hidden-folders crumb.

The full model picker shows the same PickerHint chip as the compact one.

* Screenshots of the new icon-button tooltips

Twenty-six full-window captures of the production Shell, one per tooltip
the previous commit added, each taken after the hover delay. The README
lists them and says how they were captured: an offscreen window, synthetic
input, and an in-process engine whose account, pull request, and catalog
replies are faked, so every name and number shown is invented.

* Accessible names on the icon buttons that gained tooltips

The picker's Starred and agent tabs, its favorite star, the section
dialog's and Add a theme's close, the voice error's dismiss, and Add
action's icon choices now expose a role and the same name as their
tooltip, so screen readers hear what sighted users read on hover.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: zeronsh[bot] <346184242+zeronsh[bot]@users.noreply.github.com>

* Tooltip review: model names on stars, Back's shortcut, Linux captions

- The full model picker's star says "Add GPT-5.4 to favorites", like
  the compact picker's, so a screen reader's list of stars is told apart.
- The compact picker's Back shows its shortcut the app's way,
  "Back · Esc", and exposes it as an aria key shortcut.
- The folder-trail crumb sets one tooltip instead of two conditional ones.
- Linux's own caption buttons (Minimize, Maximize / Restore, Close) were
  the last icon-only buttons with no tooltip or accessible name.
- The screenshots README notes the tooltips reworded after capture.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: zeronsh[bot] <346184242+zeronsh[bot]@users.noreply.github.com>

---------

Co-authored-by: Wing <44917547+wingleeio@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: zeronsh[bot] <346184242+zeronsh[bot]@users.noreply.github.com>
History 2026-10-26 22:01:06 +00:00
..
action-icon.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
add-theme-close.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
appearance-accent-swatch.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
background-close.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
background-zoom-in.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
background-zoom-out.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
billing-fewer-packs.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
billing-more-packs.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
cloud-copy-code.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
cloud-repositories-refresh.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
compact-picker-back.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
diff-add-comment.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
editor-add-comment.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
editor-hide-comment.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
editor-show-comment.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
markdown-add-comment.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
new-project-hidden-folders.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
picker-add-favorite.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
picker-agent-tab.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
picker-remove-favorite.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
picker-starred-tab.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
providers-refresh.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
pull-request-send-comment.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
pull-requests-clear-search.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
README.md Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
section-dialog-close.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00
voice-error-dismiss.png Tooltips on the icon-only buttons that had none (#1048) 2026-10-26 22:01:06 +00:00

Tooltips on icon-only buttons

Buttons that show only a glyph and had no tooltip now name what they do on hover, in the same chip their neighbours use.

Captured on 2026-10-25 from zeron/add-missing-button-tooltips at bdb4e0c4 (on main c04e3749): light mode, window 1280×820 logical (2560×1640 px).

A local capture driver, not part of this change, ran the production Shell in an offscreen window that never took focus, against an in-process engine with no agent harnesses. Synthetic pointer and key events did the clicking and hovering; after each hover the driver waited past the tooltip delay and saved the whole window with render_to_image. Images are uncropped; the PNGs were re-deflated losslessly.

Everything shown is synthetic: the fieldnotes project and its edits, the session, the "Studio Mac" device, the account "Ana", and the "Ridge at dawn" background. The model catalog, pull requests, Billing and Cloud come from faked engine replies; nothing reached GitHub, Stripe or an account. The voice error is the app's own message: the start failed before any audio device opened.

File Button Tooltip
markdown-add-comment.png "+" beside a Markdown table header Add comment
diff-add-comment.png "+" in a diff line's gutter Add comment
editor-add-comment.png "+" in the file editor's gutter Add comment
editor-show-comment.png Comment marker, comment closed Show comment
editor-hide-comment.png Comment marker, comment open Hide comment
picker-starred-tab.png Model picker's star tab Starred
picker-agent-tab.png Model picker's agent tab Claude Code
picker-add-favorite.png A model's star, off Add to favorites¹
picker-remove-favorite.png A model's star, on Remove from favorites¹
compact-picker-back.png Compact picker's back arrow Back¹
pull-requests-clear-search.png × in the board's search Clear search
pull-request-send-comment.png Send in the Activity comment box Send comment
appearance-accent-swatch.png An accent swatch Orange
add-theme-close.png × on Add a theme Close
background-close.png × on Adjust background Close
background-zoom-out.png − beside the zoom slider Zoom out
background-zoom-in.png + beside the zoom slider Zoom in
billing-fewer-packs.png − on the extra-credit packs Fewer packs
billing-more-packs.png + on the extra-credit packs More packs
cloud-repositories-refresh.png Refresh beside Choose on GitHub Check repositories again
cloud-copy-code.png GitHub device-code chip Copy code
providers-refresh.png Refresh beside the device menu Check for agents and updates
action-icon.png An icon choice in Add action Test
section-dialog-close.png × on New section Close
voice-error-dismiss.png × on the voice error Dismiss
new-project-hidden-folders.png "…" in New project's folder trail Show hidden folders

¹ Reworded after capture: the full picker's star now names its model, as the compact picker's does ("Add GPT-5.4 to favorites"), and Back shows its shortcut ("Back · Esc").

Validation: cargo test -p zeron-ui --lib -- --test-threads=1 at bdb4e0c4 passed (1875 tests, 0 failed), and git show --check is clean. A parallel cargo test of the same suite aborts with SIGABRT on macOS without this change too; CI runs it under nextest, one process per test.