Bulleted Lists
Use bulleted lists to present complex text in a way that's easy to scan.
Guidelines
Do
- A list should have at least two items but no more than seven items.
- Each item should be fairly short — the reader should be able to see at least two, and preferably three, list items at a glance.
- It's OK to have a couple of short paragraphs in a list item, but don't exceed that length too often.
Don't!
- Don't try to put everything on one page in lists. Use them in small doses and think of them as visual anchors so you can jump to them easily.
Properties
Introduction
Make sure the purpose of the list is clear. Introduce the list with a heading, a complete sentence, or a fragment that ends with a colon.
Capitalization
Begin each item in a list with a capital letter unless there's a reason not to (for example, it's a command that's always lowercase). If necessary, rewrite the list item so that all items begin with capital letters or all items begin with lowercase words.
Punctuation
- Don't use semicolons, commas, or conjunctions (like and or or) at the end of list items.
- Don't use a period at the end of list items unless they're complete sentences, even if the complete sentence is very short.
Examples
Default
An error message should contain:
- A level that describes its importance
- The description of the error
- Possible solutions to solve the error
With Punctuation
After creating switching to this view, you can:
- Create and delete users.
- Add, delete, or modify a role.
- Attach roles to your users.
With Proper Names
Supported Browsers
- Google Chrome
- Microsoft Edge
- Apple Safari