Skip to content

Onboarding/menu copy is too technical: drop "(HTML Preview)" and reword the post-wizard Status Page guidance #75

@taylorarndt

Description

@taylorarndt

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.

Metadata

Metadata

Assignees

Labels

enhancementExisting feature improvement.

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions