Fill in these first
- Product and audience: [e.g. accounting app for small business owners, many using English as a second language]
- Brand voice in three words: [e.g. clear, calm, helpful]
- Sample copy from the product: [paste 15 to 30 real strings: buttons, headings, errors, empty states, emails]
- Terms the team uses inconsistently: [e.g. sign in or log in, client or customer]
- Languages the copy is translated into: [list, or none]
Task
Write a short UX writing guide that a designer or developer can follow without asking a writer.
Sections to produce
- Voice: three principles, each with one do and one do not drawn from the sample copy.
- Formatting: sentence case or title case, punctuation in buttons and headings, numbers, dates, currency and time formats.
- Buttons and links: start with a verb, say what happens, preferred labels for common actions such as save, delete, cancel and continue.
- Errors: what happened, why if known, what to do next; never blame the user.
- Empty states, confirmations and destructive actions: one pattern each.
- Glossary: | Use | Do not use | Note |
- Before and after: rewrite ten strings from the sample.
Rules
- Keep the guide under 900 words; it has to be read.
- Prefer plain words that translate well; avoid idioms and jokes in errors.
- Keep every rewritten string the same length or shorter than the original where possible.






