03.6.3 · Skill in Content design

Terminology

Choosing consistent names for things in the product.

Calling the same thing by two names, or two things by one name, confuses users quickly. A small glossary keeps interface, docs, support and code aligned. Naming also shows up in APIs and data models, so it is not only a writing problem.

Your status · Terminology

Not startedLearningComfortable

Saved in this browser only. It colours this skill's tile on your map.

Resources

docsStart here
Writing and editing: plain language ↗
Office for National Statistics · 5 min
Practical plain-language rules, including one term per concept and task-first headings.
articleStart here
Ubiquitous language ↗
Martin Fowler · 2 min
Why developers and domain experts should share one precise vocabulary, and carry it into the code.

Tools

none yet

Tools for this topic are being researched.