Difference between revisions of "Lists"

Revision as of 16:07, 30 August 2013

General rules

• Do not use lists if text is read easily as plain paragraphs.
• Use proper wikimarkup.
• Do not leave blank lines between items in a bulleted or numbered list unless there is a reason to do so, since this causes the Wiki software to interpret each item as beginning a new list.
• Use numbers rather than bullets only if:
  • a need to refer to the elements by number may arise;
  • the sequence of the items is critical; or
  • the numbering has some independent meaning.
• Use the same grammatical form for all elements in a list, and do not mix sentences and sentence fragments as elements.
• When the elements are complete sentences, each one is formatted with sentence case (its first letter is capitalized) and a final period (full stop).

Bulleted lists

== Title of list ==
* Example 1
* Example 2
* Example 3

In particular, do not double-space the lines of the list by leaving blank lines or extra HTML <br> tags after them, as in this example:

== Title of list ==
* Example 1

* Example 2

* Example 3

Numbered lists

Similar to the above, use a # symbol to obtain a numbered list:

== Title of list ==
# Example 1
# Example 2
# Example 3

Blank lines between items of an ordered list will not only cause the same problems as in the previous example, but will also restart the numbering at "1".