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.
Save and practise this idea
My learning
Read. Recall. Repeat.
Save this idea and return to it on any device.
Keep exploring
Connected ideas
You are readingGive technical terms one local definition
Evidence and sources
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.
