Week 3 tutorial notes
UX Writing 101: Clear Words, Clear Decisions
Audit and rewrite one product screen as a content system, including user need, copy jobs, plain-language rewrites, accessibility checks, terminology control, tone choices, and one product decision.
Lesson thesis
Interface words are product behavior. Headings, labels, hints, buttons, links, state messages, errors, and helper text frame the task, guide action, reduce uncertainty, support accessibility, and protect trust.
Preparation status
Prepared with study notes, references, and web examples.
1. Lecture spine
Session 7 moves from interface actions to interface language. The central teaching point is that words are part of the product surface. They tell the user what the screen is for, what information is needed, what will happen next, what state the system is in, and how to recover from a problem.
This lecture should avoid treating writing as a beauty exercise. The question is not: Does this sound nicer? The stronger question is: Does this help the user complete the task with less uncertainty, less effort, and less risk?
The artifact is a clear interface text rewrite. It should include the original screen copy, the job of each text moment, a rewrite, a rationale, accessibility notes, terminology choices, and one product decision.
- 01Part 1Words as interface behaviorShow that interface words are not decoration. They frame the task, guide input, explain state, set expectations, and support recovery.
- 02Part 2The vocabulary of UX writingIntroduce user need, copy job, plain language, terminology, headings, labels, hints, action text, state copy, tone, and accessibility.
- 03Part 3Worked examplesRewrite examples from a product recommendation screen and an onboarding form, always preserving meaning and explaining the product decision.
- 04Part 4Studio practiceLearners annotate one screen, run the AI critique prompt, rewrite the screen as a content system, and present one priority decision.
2. What UX writing is really doing
The learner should understand the difference between writing a sentence and designing interface content. Interface text has a job in a system. It sits beside layout, actions, states, data, and policy.
A useful beginner distinction is this: content design decides what content is needed and where it belongs; UX writing shapes the words people see in the interface; microcopy is the small text that helps at the exact moment of decision.
The session should also challenge a common misconception. Plain language is not childish. It is precise language chosen for the user situation. Expert users also benefit from clear, scannable, direct writing because they are busy and task-focused.
Content design
The practice of planning, structuring, writing, and managing content so people can meet a real need.
Example: Deciding whether a screen needs an explanation, a form question, a warning, or a changed flow.
UX writing
Writing the interface words people use while completing a task.
Example: Writing headings, labels, button text, helper text, empty states, success messages, and error messages.
Microcopy
Small pieces of interface text that guide a user at the moment of action or decision.
Example: Password hint, Save button label, field error, tooltip, or success toast.
Plain language
Language the intended audience can understand and act on without unnecessary effort.
Example: Use "Check your details" instead of "Commence verification process".
3. Start with user need and copy job
A rewrite should start from the user need. Without this, learners may make copy shorter but less useful. A short label that hides consequence is not better. A warmer error message that does not help recovery is not better.
The copy job is the bridge between product thinking and writing. For example, the job of a page title is to orient. The job of a form label is to name expected input. The job of a button is to predict an action. The job of an error is to help recovery.
For product ownership, this creates a repeatable review method: user need, copy inventory, copy job, rewrite, risk check, decision.
- 01Step 1State the user needWrite who the user is, what they need to do or understand, and why it matters now.
- 02Step 2Inventory the textList the copy moments on the screen: heading, label, hint, action, link, message, error, and state copy.
- 03Step 3Name the copy jobName what each text moment should help the user know, decide, enter, trust, or fix.
- 04Step 4Rewrite and check riskRewrite only after the job is clear, then check whether the rewrite preserves meaning.
4. Scanning and information scent
People often scan an interface before reading it carefully. This does not mean they are careless. It means they are looking for the fastest path to task completion.
Good interface text supports scanning by putting important words first, using descriptive headings, avoiding vague link labels, and making repeated patterns predictable.
A useful teaching exercise is to ask whether the screen still makes sense if the learner only reads headings, field labels, buttons, and links. If those elements do not carry the task, the screen may be depending on body text that many users will miss.
5. Plain language and precision
Plain language is often misunderstood as removing complexity. The better definition for this course is: say the necessary thing in the clearest responsible way for this user, task, and context.
Some specialist terms are necessary. The learner should not remove legal, safety, pricing, eligibility, or technical meaning just to make a sentence shorter. Instead, explain the term the first time it appears, then use it consistently.
Plain language also includes structure. A paragraph can use simple words and still fail if the important answer is buried at the end.
6. Headings as task signposts
Headings are interface structure. They help the user scan, predict what is coming, and understand where they are in a flow. For screen reader users, headings can become a navigation map.
A good heading is descriptive enough to stand apart from the paragraph below it. It does not need to be clever. It needs to help the user recognize the task, topic, or decision.
Question headings can be useful in forms because they align with the user decision. However, they must still be clear and connected to the controls that answer the question.
7. Labels, hints, and input confidence
Labels and hints are the copy most closely tied to successful input. A label should tell the user what information is expected. A hint should add information the label cannot carry: format, consequence, example, or context.
A common beginner mistake is to use placeholder text as the only label. Placeholder text disappears during input and can be harder to review after typing. A visible label gives the user a stable reference point.
Labels should be reviewed with errors. If the label says Delivery postcode, the error should usually repeat that language so the relationship is clear.
8. Buttons, links, and action promises
Action text is where writing and interaction meet. A button label is not just a word. It is the visible promise of behavior. The learner should ask: If I press this, what do I expect will happen?
Generic labels can work when the context is obvious and the risk is low. But when money, data, deletion, eligibility, or submission is involved, the label should usually be more predictive.
Link text should describe the destination, object, or result. Avoid relying on nearby text to make a generic link meaningful. Link text should still be understandable when read out of context.
9. State and system messages
State copy helps the user understand what is true right now. Empty, loading, success, warning, and confirmation messages all change the user sense of progress and trust.
The copy should not overpromise. Loading text should not say something is complete before it is complete. A success message should confirm the result and, when useful, point to the next action.
Empty states are especially useful for beginners because they show that a blank area can still teach. A good empty state explains what is missing, why, and what the user can do next.
10. Error and recovery copy
Session 6 introduced errors as action-state behavior. Session 7 focuses on the words. A good error message should help the user recover, not merely announce that the system is unhappy.
For form errors, the message should be specific to the actual problem. Empty, too long, too short, wrong format, and disallowed characters are different problems and often need different messages.
The tone should be calm and non-blaming. If the system failed, say so. If the user needs to change something, give the next action.
- Name the field or object.
- Say what happened in plain language.
- Tell the user how to fix it when they can act.
- Preserve input where possible.
- Avoid blame, jokes, codes, and vague labels.
11. Tone, voice, and inclusion
Voice is the consistent character of a product. Tone changes with context. A product can have a friendly voice while using a calm, direct tone during errors, payments, deletion, eligibility, and personal data moments.
The learner should be careful with humor and personality. Personality that feels delightful in onboarding can feel dismissive during a failed payment or lost data moment.
Inclusive tone avoids judging the user, assuming identity or ability, or making the user feel blamed for a system or product limitation.
12. Accessibility for interface words
Accessibility makes UX writing more concrete. Descriptive headings and labels help users navigate, remember, and complete tasks. Labels and instructions help people understand what information is expected.
The learner should check both visible text and accessible meaning. A screen reader user should not receive a weaker or more confusing version of the task.
Copy should also avoid instructions that depend only on visual position or color, such as click the green button or use the box on the right. The instruction should refer to the meaningful label or action.
- Headings describe the topic or task.
- Labels describe expected input or selection.
- Visible labels are available to everyone, not only assistive technology.
- Buttons and links have names that make sense when isolated.
- Hints and errors are connected to the relevant field or control.
- Instructions do not rely only on color, shape, size, or location.
13. Terminology as a product system
Terminology is product architecture because it shapes the mental model. When a product uses different words for the same concept, the user may wonder whether the meaning changed.
A small terms list can prevent this. The list should include the preferred term, terms to avoid, and a short explanation of the concept.
Product owners should treat inconsistent vocabulary as a real product issue. It can cause support questions, onboarding friction, and mismatched implementation across teams.
14. AI UX writing critique lab
AI is useful for generating rewrite options, finding inconsistent terms, checking tone, and spotting missing copy states. But it can also produce polished copy that removes necessary meaning.
The learner should use the prompt to force structure. AI should name the copy job first, then rewrite, then explain risk. This helps prevent surface-level editing.
The human decision is essential. The learner should accept useful phrasing, adapt it to the product context, and reject anything that invents behavior, hides consequence, or reduces accessibility.
I am reviewing the words on a product screen or short flow. Context: - Product: - User: - User task: - Situation or stress level: - Desired outcome: - Current screen copy: - Known constraints: Review the copy as a UX writer and product owner. 1. Identify every important text moment: page title, heading, field label, hint, button, link, empty state, loading message, success message, warning, error, confirmation, and helper text. 2. For each text moment, name the job it should do for the user. 3. Find weak copy: vague words, jargon, hidden assumptions, duplicated text, missing instructions, blameful error language, inconsistent terms, unclear links, and labels that do not describe the expected input or action. 4. Rewrite the copy in a table with columns: current copy, copy job, proposed rewrite, why it is clearer, what risk remains. 5. Check accessibility: descriptive headings, visible labels, useful instructions, clear link purpose, and whether a screen reader user would understand the same task. 6. Check tone: helpful, calm, direct, inclusive, and appropriate for the user situation. 7. Check terminology: choose the preferred term for each concept and flag words that should not be mixed. 8. Suggest one product or design change if copy alone is trying to fix an unclear interface. 9. Finish with one priority decision: I would improve ___ first because ___. Rules: - Do not invent new product behavior. - Do not remove legal, safety, pricing, or eligibility meaning. - Use common words unless the specialist term is necessary. - Prefer clarity over personality. - Keep the user's task more important than brand voice.
- Does the prompt provide the user, task, context, current copy, and constraints?
- Does the answer identify the job of each text moment before rewriting?
- Does it preserve legal, pricing, safety, eligibility, and product meaning?
- Does it improve headings, labels, hints, actions, links, states, and errors?
- Does it check accessibility and terminology consistency?
- Does it flag when copy is trying to repair an unclear interface?
- Does it finish with one priority decision?
- The answer only makes the copy shorter.
- The answer invents new product behavior or removes necessary warnings.
- The answer makes copy more playful during a serious moment.
- The answer ignores labels, headings, links, or accessibility.
- The answer gives many rewrites but no product decision.
15. Worked example: recommendation screen
The course project example is a recommendation experience. This is a useful copy exercise because it includes product objects, filters, actions, and saved states.
The weak version says Your results, Budget, Save, and No items. None of these are completely wrong, but they are thin. They force the user to infer what kind of results, what budget means, what Save saves, and where saved items go.
The stronger version names the object and destination: recommended laptops, maximum price, save laptop to shortlist. The product decision is to improve the action and empty-state copy first because those moments affect trust and repeat use.
16. Studio exercise, rubric, and home study
The studio output is a clear interface text rewrite. It should not be a random list of improved sentences. It should show system thinking: user need, copy jobs, rewrites, rationale, risk, accessibility, terminology, and decision.
For home study, the learner should collect one confusing screen and rewrite it using the same structure. The tutor should ask the learner to defend one rewrite that became longer because it preserved important meaning.
The lecture can close by reminding learners that a Product Owner with design specialist capability should be able to explain why important words are present, what they help the user do, and what product risk they reduce.
- 01Part AChoose the screenSelect one existing screen or course project screen with at least eight text moments.
- 02Part BAnnotate the textMark the heading, labels, hints, buttons, links, state messages, errors, and helper text.
- 03Part CRewrite as a systemFor each text moment, write the user need, copy job, rewrite, rationale, and remaining risk.
- 04Part DReview and decideCheck accessibility, tone, terminology, and whether the interface itself needs to change.
- Names the user, task, context, and desired outcome.
- Inventories at least eight important text moments.
- Explains the job of each text moment before rewriting.
- Uses plain language without removing necessary meaning.
- Improves headings, labels, hints, actions, links, states, and errors.
- Checks accessibility for headings, labels, instructions, and link purpose.
- Creates a short terminology list with preferred and avoided terms.
- Ends with one priority product decision and a reason.
Follow-up reading for the lecturer
References
GOV.UK Service Manual guidance on writing for transactional interfaces: short, direct, inclusive copy that helps people complete tasks without extra explanation.
GOV.UK: Writing for GOV.UKGOV.UK content design guidance on writing for the web, meeting user needs, using plain English, and structuring content for scanning.
GOV.UK: User needsGOV.UK guidance on writing user needs from the user perspective before choosing content or interface solutions.
Digital.gov: Plain Language Web Writing TipsDigital.gov guidance on writing web content around audience, task order, scannability, plain language, descriptive links, and testing with real users.
Digital.gov: Principles of plain languageDigital.gov plain language principles: define the audience, use active voice, organize information, and test whether people understand the intended message.
W3C WCAG: Labels or InstructionsW3C guidance on labels and instructions for inputs, including why visible guidance matters for people who need to understand what information is expected.
W3C WCAG: Headings and LabelsW3C guidance on descriptive headings and labels, with accessibility benefits for scanning, memory, navigation, and form completion.
Material Design: WritingMaterial Design writing guidance on simple, concise, direct language, consistent terminology, user-focused phrasing, and action-oriented UI text.
GOV.UK Design System: Error messageGOV.UK Design System guidance on error messages that are specific, concise, matched to labels, and written to help the user recover.
Shopify Polaris: Inline errorShopify Polaris guidance on inline errors that are brief, contextual, specific, and tied to the relevant field for assistive technology.
Apple HIG: Text fieldsApple guidance on text fields, including visible labels, placeholder limits, appropriate input support, and validation at the right time.
Material Web: ButtonsMaterial Web guidance that button labels should describe the action that will occur, with accessibility support for more descriptive labels when needed.
Web examples
This is the central model for the session: interface words should reduce mistakes, include people with different reading levels, and avoid explaining a broken interface when the interface itself should be improved.
GOV.UK Design SystemSpecific, recoverable error messagesThe GOV.UK error message pattern shows how label language, hint text, inline error text, preserved input, and recovery guidance work together as one content system.
Material DesignSimple, direct UI writingMaterial writing examples make the rewrite discipline visible: remove introductory phrases, use common verbs, avoid invented feature names, and keep terminology consistent across a flow.
Digital.govPlain language web writing checklistDigital.gov frames plain language as a task-support practice, not decoration. It connects audience, word choice, order, link text, scannability, and testing.
W3C WAIDescriptive headings and labelsWCAG headings and labels guidance helps learners see that copy quality is also accessibility quality: labels and headings must be accurate, descriptive, and useful outside the visual layout.
Shopify PolarisInline error copy in contextPolaris inline error guidance is a strong product example because it pairs content, placement, brevity, and technical association through field identifiers and assistive descriptions.
Inventory screen copy, classify headings, labels, hints, actions, links, states, and errors, run the Session 10 prompt, revise the copy, and defend the highest-priority improvement.
- Can the learner start from user need before rewriting copy?
- Can the learner identify the job of each text moment?
- Can the learner improve headings, labels, hints, buttons, links, states, and errors without removing necessary meaning?
- Can the learner explain terminology choices and avoid mixing words for the same concept?
- Can the learner check accessibility for headings, labels, instructions, link purpose, and assistive descriptions?
- Can the learner decide when copy alone is trying to fix an unclear interface?
I am reviewing the words on a product screen or short flow. Context: - Product: - User: - User task: - Situation or stress level: - Desired outcome: - Current screen copy: - Known constraints: Review the copy as a UX writer and product owner. 1. Identify every important text moment: page title, heading, field label, hint, button, link, empty state, loading message, success message, warning, error, confirmation, and helper text. 2. For each text moment, name the job it should do for the user. 3. Find weak copy: vague words, jargon, hidden assumptions, duplicated text, missing instructions, blameful error language, inconsistent terms, unclear links, and labels that do not describe the expected input or action. 4. Rewrite the copy in a table with columns: current copy, copy job, proposed rewrite, why it is clearer, what risk remains. 5. Check accessibility: descriptive headings, visible labels, useful instructions, clear link purpose, and whether a screen reader user would understand the same task. 6. Check tone: helpful, calm, direct, inclusive, and appropriate for the user situation. 7. Check terminology: choose the preferred term for each concept and flag words that should not be mixed. 8. Suggest one product or design change if copy alone is trying to fix an unclear interface. 9. Finish with one priority decision: I would improve ___ first because ___. Rules: - Do not invent new product behavior. - Do not remove legal, safety, pricing, or eligibility meaning. - Use common words unless the specialist term is necessary. - Prefer clarity over personality. - Keep the user's task more important than brand voice.
Home study
Choose one confusing product screen with at least eight text moments. Annotate each text moment, name its job, rewrite it, explain the rationale, list terminology choices, check accessibility, and choose one priority improvement.