Lists

June 9, 2026 · View on GitHub

Guidance

Use numbered lists for sequential steps. Use bulleted lists for non-sequential items. Use parallel structure within any list — all items should follow the same grammatical pattern.

Examples

Do (numbered — sequential):

  1. Select Local Traffic > Virtual Servers.
  2. Select Create.
  3. Enter a name for the virtual server.

Do (bulleted — non-sequential):

Before you begin, verify that you have:

  • A valid license
  • At least one pool configured
  • Network access to the management interface

Don't:

  • First, select Local Traffic.
  • Then you should select Virtual Servers.
  • Creating the virtual server is the next step.

Notes

Start each bulleted item with the same part of speech — either all nouns, all verbs, or all phrases. Don't mix.

Start each numbered step with an imperative verb: "Select," "Enter," "Configure."

Avoid nested lists more than two levels deep. If you need more than two levels, consider restructuring the content.

See also

Browse all guidelines