Skip to content

docs: usability walkthroughs and findings (November 2026) - #469

Merged
ManuelStaggl merged 3 commits into
mainfrom
docs/usability-2026-11
Nov 16, 2026
Merged

ManuelStaggl merged 3 commits into
mainfrom
docs/usability-2026-11

Conversation

@ManuelStaggl

Copy link
Copy Markdown
Collaborator

Usability offensive, phase 1–2: walkthroughs of tasks 1–7 in the real app and the report with 25 findings.

  • e2e/usability.spec.ts: opt-in walkthroughs (PARTBUDDY_USABILITY, PARTBUDDY_E2E_SOLIDCRAFT=1), DE/EN, 960×600, keyboard only, without SolidCraft and signed out; per step picture, time, axe, clipped texts and visible notices.
  • Fake Claude learns the endings of a usage limit and a lost connection (Hit my limit, Go offline).
  • docs/usability-2026-11.md: findings U-01…U-25 with severity, effort and the approved fix; implemented in the following PRs.

No app code changes. Checked: typecheck, eslint on the changed files, the walkthroughs locally (7 passed).

🤖 Generated with Claude Code

ManuelStaggl and others added 2 commits November 16, 2026 07:48
Walkthrough spec for tasks 1-7 (opt-in), fake Claude learns the
limit and offline endings, report docs/usability-2026-11.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
ManuelStaggl added a commit that referenced this pull request Nov 16, 2026
…r an open part (#470)

Usability offensive group 1 (docs/usability-2026-11.md, on #469).

- **U-02** Two texts used `{{value}}` instead of ICU `{value}`; the user
saw „{{value}}“ verworfen, {{kept}} bleibt. Fixed in de/en;
`i18nKeys.test.ts` now forbids `{{name}}`.
- **U-08** A size changed in the parameter list shows its name in the
chat („Höhe auf 120 mm gesetzt“), not `plate_height`. The phrase drops
the word „Maß/Dimension“ (contract test texts follow).
- **U-09** On an open part (template, import) the empty chat asks „Was
soll anders werden?“, says to change a value on the left or describe the
change, and offers examples from the part's own sizes. „SolidCraft“ is
gone from the start text.

| Before | After |
|---|---|
|
![before](https://raw.githubusercontent.com/PartBuddy/partbuddy/46b1761db513fc0676607cebbf5bc1ad7674524d/docs/screens/usability-2026-11/U-09-vorher.png)
|
![after](https://raw.githubusercontent.com/PartBuddy/partbuddy/46b1761db513fc0676607cebbf5bc1ad7674524d/docs/screens/usability-2026-11/U-09-nachher.png)
|

U-02 before:
![U-02](https://raw.githubusercontent.com/PartBuddy/partbuddy/46b1761db513fc0676607cebbf5bc1ad7674524d/docs/screens/usability-2026-11/U-02-vorher.png)

Checked: typecheck, eslint, unit tests (1205 passed; `versions.test.ts`
failed once under load and passes alone), E2E parameter panel,
walkthrough switch/import/export.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: ManuelStaggl <17688572+ManuelStaggl@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ManuelStaggl
ManuelStaggl merged commit af3f36b into main Nov 16, 2026
10 checks passed
@ManuelStaggl
ManuelStaggl deleted the docs/usability-2026-11 branch November 16, 2026 07:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant