Skip to content

A research note on reading, crowding and finding, and the ten measures (closes #628) - #633

Merged
BattermanZ merged 1 commit into
devfrom
docs/628-ux-research
Nov 17, 2026
Merged

BattermanZ merged 1 commit into
devfrom
docs/628-ux-research

Conversation

@BattermanZ

Copy link
Copy Markdown
Member

Closes #628

Adds docs/research/ux-reading-crowding-and-finding.md, the research the UX audit (#627) judges screens against:

  • Findings. Each NN/g, WCAG, Apple, Android/Material and GOV.UK source was checked again at its own page on 2026-11-17. Each finding has its conditions (year, device, number of people, kind of task) and its kind of evidence, and each one measured off a phone app is marked.
  • Phone survey. How Paprika 4, Mela, Crouton, Mealie and Tandoor handle finding, opening and sharing a recipe. It draws on source code, first-party guides, App Store screenshots and a count on Mealie's public demo at 402 × 874.
  • The ten measures. Words, Room, Controls, Unmarked actions, Tap size, Gaps, Type and colour, Length, Notices and Depth. Each has a definition a tool can count and a threshold tied to a finding or to the survey, with judgement calls labelled.

Documentation only: just check and just test ran in docs-only mode and passed. No CHANGELOG line, since nothing changes for a cook, an Operator or an agent.

🤖 Generated with Claude Code

https://claude.ai/code/session_013rPDLiRuBoxYfQJUEtSDrB

…s the audit counts

docs/research/ux-reading-crowding-and-finding.md writes down the
studies and guidelines the UX audit judges screens against, each with
the conditions it was measured under, surveys how Paprika, Mela,
Crouton, Mealie and Tandoor lay out finding, opening and sharing a
recipe on a phone, and defines the ten measures `just ux-measure` will
count, each with a threshold tied to a finding or to the survey.

Closes #628

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013rPDLiRuBoxYfQJUEtSDrB
@BattermanZ
BattermanZ merged commit fd6b777 into dev Nov 17, 2026
1 check passed
@BattermanZ
BattermanZ deleted the docs/628-ux-research branch November 17, 2026 09:44
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