Lists
tip
To document a sequence of actions, use procedures.
<list type="decimal" start="2">
<li>First item.
<list type="alpha-lower">
<li>First indented item.</li>
<li>Second indented item.</li>
</list>
</li>
<li>Second item.</li>
<li>Third item.</li>
<li>Fourth item.</li>
</list>
<list type="bullet">
<li>Some list item</li>
<li>Another list item</li>
<li>Yet another list item
<list type="bullet">
<li>Indented item</li>
<li>Indented item</li>
</list>
</li>
<li>One more item</li>
</list>
note
Guidelines for listsThese are not strict rules, but it is better to keep the following in mind when adding lists:
Write a paragraph before a list to introduce it. A list without an introduction can be unclear.
Include between 2 and 8 items in a list. Having too many items can be overwhelming and you will emphasize nothing. If you need a long list of short items, consider using multiple columns.
Limit the size of each item as much as possible. Do not expand a list item beyond its most basic idea. If you need to provide a lot of details for each item, consider using a definition list or splitting the content into chapters.
Avoid overusing lists. Lists are a good way to add structure between paragraphs, but having all content as lists does not provide the necessary context. Also, consider other elements, such as tables and tabs.
Thanks for your feedback!