Product area
Onboarding / UI copy / accessibility
Severity
P3 - polish (confusing wording)
Summary
The post-wizard guidance and several menu labels are too technical for everyday users. After the startup wizard, Quill says:
After Wizard — Open Help > Status Page (HTML Preview) to monitor task activity, feature state, and speech setup health.
"HTML Preview", "task activity", "feature state", and "speech setup health" are developer terms. End users (including screen-reader users hearing this) shouldn't need to parse implementation language.
What to fix
- Reword the post-wizard message to plain language, e.g. "You're all set. To check on downloads, speech, and what's turned on, open Help → Status Page."
- Drop "(HTML Preview)" from user-facing menu labels and titles — it describes how it's rendered, not what it does. It appears in several places in
quill/ui/main_frame.py:
help.status_page menu: "Status &Page (HTML Preview)" (~3576)
- "Status Page (HTML Preview)" title (~1856)
- "&About Whisperer (HTML Preview)..." (~3322), "&Capability Matrix (HTML Preview)" (~3422), "BITS Whisperer Capability Matrix (HTML Preview)" (~1509), "About BITS Whisperer (HTML Preview)" (~1850)
- Plain-language pass on the wizard status text (
quill/ui/main_frame.py ~9157: "Use Status Page to monitor tasks, speech downloads, and feature state.").
Acceptance
- No user-facing string contains "HTML Preview" or jargon like "feature state" / "speech setup health".
- The post-wizard guidance reads as friendly, plain English.
Product area
Onboarding / UI copy / accessibility
Severity
P3 - polish (confusing wording)
Summary
The post-wizard guidance and several menu labels are too technical for everyday users. After the startup wizard, Quill says:
"HTML Preview", "task activity", "feature state", and "speech setup health" are developer terms. End users (including screen-reader users hearing this) shouldn't need to parse implementation language.
What to fix
quill/ui/main_frame.py:help.status_pagemenu: "Status &Page (HTML Preview)" (~3576)quill/ui/main_frame.py~9157: "Use Status Page to monitor tasks, speech downloads, and feature state.").Acceptance