Definition lists

⌘K

Use a definition list to define a set of terms, descriptions, explanations, or associations.

You can add a paragraph break after each definition if the formatting is tight.

Qualities of definition lists

Definition lists must have the following qualities:

  • A complete lead-in sentence
  • More than one defined term
  • Up to two levels: the term, which is in bold and on its own line, and the definition, which is at least one full sentence indented on its own line
  • Parallel sentence construction
  • One action for each list item
  • End punctuation in every definition line

For more guidance on using lists, see Best practices for writing with lists.

Example

The following example of a definition list contains a complete lead-in sentence. Each item in the list uses parallel construction and complete sentences.

Drucare Cloud differs from Drucare Enterprise in the following ways:

Command line interface (CLI)
Drucare Cloud customers don’t have access to the command line. Drucare Support must perform tasks that require CLI access.
Apps
Only Drucare inspected and approved apps are permitted to run in a Drucare Cloud deployment.
License pooling
Drucare Cloud doesn’t allow license pooling.
Two-factor authentication
Drucare Cloud doesn’t support two-factor authentication.