Polish setup's wording and small visual details
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 48/100
調査の方向性
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.
索引モデルが issue の本文から書いたものです。
説明
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.
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).
- 主要言語
- Swift
- スター
- 184
- フォーク
- 12
- 平均マージ
- 3時間 50分
- マージ済み PR(30日)
- 387
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
Seb-GRAF/StableBar のほかの issue
-
enhancement
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
メンテナーはふだん 1 日以内に返信
-
enhancement
難易度 4/5 3〜5日 初心者へのやさしさ 52/100
メンテナーはふだん 1 日以内に返信
-
Menu bar items drawn as in the menu bar show the wrong part of the menu bar after a display change対応中かも @Jonathanm10 が今日担当しました。 オープンneeds-triage
難易度 2/5 1〜3時間 初心者へのやさしさ 35/100
メンテナーはふだん 1 日以内に返信
-
enhancement
難易度 5/5 1週間以上 初心者へのやさしさ 30/100
メンテナーはふだん 1 日以内に返信
-
Allow the App Menu to display the frontmost app icon対応中かも @khatami10 が今日担当しました。 オープンenhancement needs-triage
難易度 3/5 1〜2日 初心者へのやさしさ 35/100
メンテナーはふだん 1 日以内に返信
Seb-GRAF/StableBar の issue をすべて見る
似ている issue
-
good first issue help wanted testing
難易度 1/5 1時間未満 初心者へのやさしさ 78/100
-
area:cli documentation good first issue priority:low
難易度 1/5 1時間未満 初心者へのやさしさ 94/100
isaaclins/freesnitch#430 ·
メンテナーはふだん 1 日以内に返信
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
MasterJ93/ATProtoKit#354 ·
-
enhancement help wanted
難易度 2/5 1〜3時間 初心者へのやさしさ 84/100
heysidhant/appvanish#4 ·
-
bug priority:low status:queued
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
メンテナーはふだん 1 日以内に返信