Replace a term when your reader does not know it and does not need it. Explain it when the reader needs it. Keep it as is when your readers already use it.

The rest of this page shows how to find insider terms in your own draft and how to handle abbreviations. It also covers the cases where a term has to stay.

What counts as jargon

The Nielsen Norman Group defines jargon as the specialized language of a profession or group, which is unfamiliar or meaningless to outsiders. The same article makes a key point: jargon is relative. A word can be clear to you and meaningless to your reader.

Digital.gov describes jargon as complicated language used to impress rather than to inform. It says readers complain about jargon more than any other writing fault. The reason, it explains, is that writers often forget that terms they know well may be difficult or meaningless to the audience.

Its own example is short. "River birds" beats "riverine avifauna" for most readers.

Find it in your draft

Read the text as an outsider would. Mark four kinds of words:

  1. Trade terms. Words from your field that outsiders rarely use.
  2. Abbreviations and acronyms. Anything made of capital letters or shortened to fit.
  3. In-house nicknames. Names for forms, rooms, projects or processes that only your group uses.
  4. Shortcuts like e.g. and i.e. Digital.gov says few people know what they mean and many confuse the two. Write "for example" or "such as".

Then ask someone outside your group to circle any words they would not use. Their circles are worth more than your guesses.

Replace, explain or keep

The Nielsen Norman Group's decision method rests on two questions. How many readers know the term? How important is the term in this text? The table turns its advice into three outcomes.

Do most readers know it?Do they need this exact term?What to do
YesDoes not matterUse it without explanation.
NoNoReplace it with plain words.
NoYesUse the plain words and the term together.

For the third case, the Nielsen Norman Group suggests a pattern: plain words first, with the term in brackets. If most of your readers know the term, flip the order.

Before: The SOP says the AV lead must file the QA checklist with the PMO by EOD.

After: The written room guide says the sound and video lead must hand the quality checklist to the project office before the end of the day.

Every abbreviation is gone, and nothing was lost. The "after" is longer by nine words. The Nielsen Norman Group makes the same point about spelling out acronyms: extra words are an acceptable tradeoff if clarity improves.

Handling abbreviations and acronyms

Some abbreviations cannot be avoided. Use these rules:

  • Define on first use. Write the full phrase and put the abbreviation in brackets once.
  • Limit the number. Digital.gov says to use no more than three in one document, and preferably two.
  • Use a nickname instead. Digital.gov suggests simple names such as "the committee" in place of a long abbreviation. The reader gets meaning, not letters.
  • Skip definitions for what everyone knows. Digital.gov says that if everyone knows an abbreviation, use it without explanation.
  • Repeat in long pages. The Nielsen Norman Group says readers do not read a long page in order. Connect the abbreviation to its full form at the start of each major section.

The Nielsen Norman Group also warns that one set of letters can mean many things. Its example is "GTA", which can stand for a video game, a music group or a metropolitan area.

The W3C accessibility standard WCAG 2.2 has a success criterion on this at Level AAA. It asks for a way to find the expanded form of abbreviations. It exempts abbreviations that have become part of the language. Its example is "laser", which began as an abbreviation and is now an ordinary word.

When the term has to stay

Digital.gov is clear that avoiding jargon does not mean removing necessary technical terms. Three cases call for keeping the word:

  • The term is printed on the thing. If "HDMI" is stamped on the cable, the notice needs "HDMI".
  • The reader needs the exact word. If a form uses a specific title, the instructions must use it too.
  • The term is the shortest way to say it. If every reader knows it, keep it.

When you keep a term, define it where you use it. Digital.gov advises against long definition sections at the start or end. If you must have one, put it at the end and list the terms in alphabetical order.

Do not define common words. Do not define words you never use.

For everyday word swaps, see simple words instead of long ones. For labels, see labels and signs: short text that points the way.

Common mistakes

  • Swapping jargon for a vague phrase. "The thing for the process" replaces nothing. Be specific.
  • Defining a term once, far from where it is used. A reader on page five has forgotten page one.
  • Assuming everyone knows. Your colleagues know. Your readers may not.
  • Explaining what experts already know. The Nielsen Norman Group warns that explaining a well-known term can make experts feel the text was not written for them.
  • Using the same letters for two things. Choose one meaning per abbreviation.
  • Keeping an in-house nickname. If only your group uses it, outsiders will not understand it.

The Easy-Read Editor marks long words, which is a useful way to spot candidates. It cannot know what your readers know. That call stays with you. For help with it, read write for one reader.

FAQ

Should I avoid every abbreviation?

No. Digital.gov says to limit them to three or fewer per document, and to skip the explanation when everyone knows them. Spell out the rest.

Do I need a glossary?

Only if a term has to stay and a short definition in the text will not do. Keep it brief, put it at the end and keep terms alphabetical.

What about writing for experts?

It depends on the term. The Nielsen Norman Group warns that explaining a basic, well-known term to a narrow expert audience may backfire, because experts judge whether the text was written at their level.

Is it all right to use a term and its plain version together?

Yes. It is often the best option for an important term. The plain words let new readers follow, and the term lets informed readers confirm they have the right one.

Sources

Each page below was opened and read on the date shown. Where a fact comes from one of them, the guide says so.

This guide gives general information about readability. See the Disclaimer. To report a mistake, use the Corrections page.