Polish setup's wording and small visual details

Aperta
#467 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
48/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
macos, swift
Ambito
design, desktop

Direzione di ricerca

Start with the referenced setup files: Sources/StableBar/SetupPreferences.swift, SetupTour.swift, SetupDemo.swift, SetupWindow.swift, and BarView.swift. Review the setup flow and its wording, progress dots, preset icons, closing card, menu-bar guidance, and contrast, then check the related step ordering in issue #450. Done when the proposed details are addressed consistently across setup and the bar's right-click menu.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

enhancement P3

Problem

Small details from a UX review of setup. Each is minor; together they make setup harder to read.

  • "Keep current" means nothing on a first run. That covers Keep current for Appearance and Clock, and the theme's Current badge. On a new configuration, Keep current is the same as Automatic and as 24-hour (Sources/StableBar/SetupPreferences.swift:4-14).
  • Six progress dots for five steps. The dots don't match "1 / 5" because the first dot stands for the intro (Sources/StableBar/SetupTour.swift:886-895).
  • Placement goes by three names: Replace / Keep the menu bar, Top edge / Below menu bar, and Keep the menu bar instead.
  • "Click any of them." reads as an instruction (Sources/StableBar/SetupDemo.swift:20), but the demo bar can't be clicked.
  • The preset tiles' widget icons are 8.5 pt (SetupTour.swift:490), too small to tell apart.
  • The closing card.
    • Edit Bar in Place wraps onto two lines next to Open Settings.
    • "Undo restores the previous step" describes the bar editor, not setup (Sources/StableBar/SetupWindow.swift:415).
  • Hints point to a hidden icon. Step 5's Use the menu-bar icon and the card's "Reopen this guide with Getting Started… in the menu-bar icon's menu." point to an icon that sits in the hidden macOS menu bar once StableBar has replaced it. The bar's own right-click menu has no Getting Started… (Sources/StableBar/BarView.swift:164-180).
  • Grey text loses contrast (white at 45–60%) when the drifting background turns bright behind it, for example around step 1's permission card.
Closing card: Edit Bar in Place wraps onto two lines

Proposal

  • Use plain first-run wording (Automatic, the system's clock format), and keep Keep current for reopened setups.
  • Make the dots match the step count.
  • Pick one pair of names for placement.
  • Narrate the demo ("We click the clock…"), or make it interactive.
  • Enlarge the preset icons.
  • Fit Edit Bar in Place on one line and use setup's own words on the card.
  • Add Getting Started… to the bar's right-click menu.
  • Darken the area behind the text.

Related

  • #450: reorders setup's steps.

Triaged by Claude Code (Claude Opus 5.5).

Lingua principale
Swift
Stelle
184
Fork
12
Merge medio
3h 50m
PR unite (30g)
387

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di Seb-GRAF/StableBar

Tutte le issue di Seb-GRAF/StableBar

Issue simili

Altre issue su Swift

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.