Foundations

Lay & patient-facing design

Everything else in this system is written for a trained reader whose judgement catches the interface's mistakes. This page is for the case where that reader does not exist — where the person using the software is the patient, has no training, no supervision, and nobody to ask.

Stable · v1.0 WCAG 2.2 AA IEC 62366-1 Framework · ISO 9241-11

Overview

Voice & tone defines a clinical register: precise, hedged correctly, written for someone who knows what a reference range is. That register is right for every clinician-facing surface here and actively unsafe on a patient-facing one, where its precision reads as reassurance and its hedging reads as vagueness.

This is a second register, not a simplified version of the first. Simplifying clinical prose produces something that is still clinical prose with shorter words in it. What is needed is different content: what happened, what it means for you, and what to do — in that order, in sentences a tired person can act on.

The assumption that fails here

Clinical software is designed for a reader who can tell when the screen is wrong. A clinician seeing an implausible value checks the electrodes. A patient seeing an implausible value believes it — and may act on it. Removing the expert reader removes the last error-detection layer in the entire system, and everything on this page is an attempt to put something back in its place.

Say what to do

A patient-facing screen that only conveys information has done half a job. The action is the part that changes an outcome.

Assume the worst moment

The interface is read at 3 a.m., one-handed, by someone frightened or physiologically impaired. That is the design case, not the edge case.

Comprehension is measurable

Whether a person understood is testable, and until it is tested it is an assumption rather than a claim.

Two registers

Clinical registerLay register
Reader Can detect an implausible output Cannot. Believes the screen
Primary content The finding, its provenance and its limits What it means for this person, and what to do
Hedging Precise and necessary — "suspected", "cannot be excluded" Read as evasion. State the uncertainty as an instruction instead: "this needs checking by a person"
Numbers Values with units and reference ranges Values with what they mean; ranges only where the person acts on them
Vocabulary Clinical terms, unglossed Everyday words; clinical term added in brackets where the person will meet it again
Failure Ambiguity a clinician resolves from context Confident misunderstanding, acted on alone

Numbers a person can use

Numeracy is unevenly distributed and does not correlate with intelligence or education in the way designers assume. Probabilities, ratios and decimals are all understood poorly by a large proportion of adults, and the ones who misread them do not know they have.

Instead ofUseWhy
"a 12% chance""about 12 in every 100 people" Natural frequencies are understood far more reliably than percentages.
"a 1 in 8 risk""about 12 in every 100" Keep the denominator constant across every risk on the screen, or they cannot be compared.
"your risk is doubled""from 2 in 100 to 4 in 100" Relative change without a baseline is uninterpretable and reliably alarming.
"0.5 units""half a unit (0.5)" Decimals are a dose-error source. A misread decimal point is a tenfold error.
"within normal limits""in the usual range" "Normal" is heard as a judgement about the person.

The worst moment is the design case

The user is impaired exactly when they need the interface most

Hypoglycaemia is a cognitive impairment. So is pain, panic, exhaustion, and being woken from deep sleep. A patient-facing medical device is disproportionately used at the moments its user is least able to read carefully, reason about numbers, or recover from a mis-tap — and those are precisely the moments its output matters most.

Every readability, target-size and action-count rule in the rest of this system was written for a tired clinician. Here they are insufficient, and the correct response is not to make the interface prettier but to make the urgent path shorter, larger and harder to get wrong.

Comprehension is a measurement

Every rule above is a Reasoned claim in the sense defined on Status & limitations. None of it is evidence that a particular person understood a particular screen, and that is not a gap this system can close on a manufacturer's behalf.

MeasureHow it is obtained
Recall Can the person state, unprompted, what the result said and what they should do?
Correct belief What do they now think was assessed — and, critically, what do they think was excluded? This is where scope failures show up.
Intended action Presented with a change in symptoms, what would they do and how quickly?
Error under load The same tasks with time pressure, interruption, or a simulated impairment.
Range of users Including low literacy, low numeracy, non-native speakers, older adults and people with the condition — not a convenience sample of colleagues.

Formulaic reading-level scores are a weak proxy and a useful floor: they measure sentence and word length, not whether an instruction was understood. Use them to catch obvious drift, never as evidence of comprehension.

Do's and don'ts

Do

Your results show something that needs checking by a doctor. The clinic will contact you within 5 working days.

What happened, what it means, what happens next — and a named timeframe the person can hold someone to.

Don't

Your results were not entirely within normal limits. Follow-up may be indicated.

Two hedges and a passive construction. The person cannot tell whether this is serious, whether anyone is doing anything, or what they should do.

Do

This happens to about 12 in every 100 people who take this medicine. It does not happen to the other 88.

A natural frequency with a constant denominator, and both directions. Comparable against every other risk on the screen.

Don't

Incidence of this side effect is 12%, representing a 2.4-fold increase over baseline.

A percentage, a relative multiplier and no baseline. Reliably read as more frightening than it is, by the people least able to check.

Do

If your vision becomes blurred or suddenly worse, contact your optometrist or GP the same week.

Named symptoms, named contact, named urgency. The person can check themselves against it without interpreting anything.

Don't

Seek medical attention if you experience any concerning symptoms.

It asks the person to perform the triage the device exists to help with. "Concerning" is exactly the judgement they do not have.

Do

Take half a unit (0.5) now.

Words and numeral together, leading zero present. A misread decimal point cannot produce a tenfold dose.

Don't

Administer .5U stat.

A naked decimal, an abbreviated unit and a Latin abbreviation, on a screen read by a frightened person at three in the morning.

Accessibility

Clinical safety notes

Risk controls carried by this foundation

Trace these in your risk file (ISO 14971) and usability engineering file (IEC 62366-1).

NotJustAnyMed.Tech Design System · Lay & patient-facing design · v1.0 · draft for review
Reference applications named in this system are fictional; all copy shown is illustrative and has not been tested with patients.