Principle

Give technical terms one local definition

Shared words can hide unshared models.

Work through the ideaIllustrative example

Define the state the reader could misread.

A fictional booking system calls an unconfirmed room allocation “held.”

Blank cream letter sheets and a dark binder clip in a mustard envelopeA draft you can inspect

“Held” can sound like “confirmed.”

The reader may assume a state the record does not establish.

The room is held. We can proceed.
Which terms need a local definition?

Necessary terms whose ambiguity could change the reader's understanding or action.

A local explanation must not silently redefine standard, regulated or system terminology.

VedokrokKeep the idea. Try the next move.

Before you use it

Use when
  • A specialist message uses a term that different teams interpret differently.

Keep this limit in mind

  • Local definitions should not silently redefine regulated or system-standard terminology; use authoritative definitions where they exist.

Why it matters

When a term is necessary and potentially ambiguous, define it once where first used or point to the authoritative glossary. Prefer the team's actual domain term over a simpler but inaccurate substitute. Do not expand every familiar acronym mechanically.

An example

'Activated = change request completed and BP data written to active area; it does not mean DRF replication finished.'

Check your result

The term has one operational meaning for this message.

An idea to explore.

Try this idea.

Inspect the example, try the idea in your situation, then check your next move.

Keep reading
Save and practise this idea

My learning

Read. Recall. Repeat.

Save this idea and return to it on any device.

Use email
Keep exploring

Connected ideas

You are readingGive technical terms one local definition

Evidence and sources
Supports

CDC guidance recommends active voice and familiar audience language, with technical terms explained where needed.

Technical precision should not be removed when it is necessary for the task.

Description and Examples of Index Items · Core items 6 and 7

All sources (1)
Edition and review

Version 0.1.0

No review details are supplied for this edition.

Read this idea as JSON · Release details