127Terms

An inline glossary. Salesforce writing is dense with terms a newcomer has not met, and sending them to a separate glossary page loses them.

Use it for

The first time a cluster of jargon appears
Object and field names a reader will meet again

Not for

A single definition — define that inline, in the sentence
Long explanations — a term entry is a sentence

Glossary

markup

<aside class="ns-terms">
  <span class="ns-terms__label">Terms in this section</span>
  <dl>
    <dt>Profile</dt><dd>What a user can do to an object — create, read, edit, delete.</dd>
    <dt>Permission set</dt><dd>Additive grants on top of a profile. Never subtractive.</dd>
    <dt>Role</dt><dd>Position in the hierarchy, which decides record visibility upward.</dd>
  </dl>
</aside>

Accessibility contract

A real <dl>, so the term/definition pairing is announced
Stacks to one column below 48rem