Lists

Bulleted lists

In general, if any list item completes the introductory phrase, use a colon after the introductory phrase and add a period after each list item.

Examples

System administrators can:

• Add new users.
• Delete users.
• Review and export logs.

info

Don't use periods if all list items have three or fewer words.

The tab displays:

• The metric key
• The definition
• The name

info

Don’t use a colon after an introductory phrase if list items don’t complete the sentence.

System requirements

• 16 GB RAM
• 64 GB storage
• Windows 11+

info

If list items are complete sentences in themselves, use a period after the list items—in this case, they don't complete the introductory phrase, so there's no colon.

Aspects to consider for any proposed feature

• Understand the pain point your feature addresses.
• Research competitive offerings.
• Determine how many sprints it will take to develop the feature.

Numbered lists

Use numbered lists for procedural "how to" steps that must be accomplished in sequence or for list items in ascending or descending value (for example, least to most important). There's no need to include a colon after an introductory phrase. In the case of procedures, each list item is a complete sentence.

Example

To install the extension

1. Download the extension installer.
2. Run the installer on your local machine.
3. Close the installer when installation is complete.