These guidelines define how to use bullet and numbered lists in our documentation to improve clarity, consistency, and usability.
Key Rule
Use bullet lists when order does not matter.
Use numbered lists when order does matter.
If changing the order would confuse the user or break the process use a numbered list.
Bullet Lists (Unordered)
Use when:
Items are not sequential.
All items have equal importance.
You are listing features, options, or key points.
Example
The system supports:
Multiple user roles.
Real-time notifications.
Offline mode.
Numbered Lists (Ordered)
Use when:
Steps must be followed in a specific order.
The sequence affects the outcome.
You need to reference steps later.
Example
To install the application:
Download the installer.
Run the setup file.
Restart your system.
Best Practices
When creating lists (of any kind), keep the following best practices in mind.
Start lists with a clear lead-in sentence (usually ending with a colon or full stop). A strong lead-in helps users understand what the list represents before they scan it. It also ensures each item logically completes or relates to that sentence.
Keep list items concise and scannable. Short items make it easier for users to quickly find relevant information without reading full paragraphs.
Use parallel structure (same grammatical pattern). Consistent grammar improves readability and makes the list feel structured and professional. For example, start each item with the same verb form (such as all imperative verbs).
Ensure each item expresses one idea. Breaking complex information into single ideas prevents confusion and cognitive overload. If an item includes multiple concepts, consider splitting it into separate entries.
Use lists when you have 3 or more items. For fewer than three items, a simple sentence is usually clearer and more natural.
Common mistakes
When used incorrectly, lists do more harm than good. Avoid the following:
Using bullets for step-by-step instructions.
Using numbers for items that are not sequential.
Mixing sentences and fragments in the same list.
Writing long paragraphs as list items.
Creating lists with only one item.
Final Checklist
Before publishing, verify:
Is the list type correct for the content?
Are items parallel and consistent?
Is the list easy to scan?