Wikipedia:List guideline
From Wikipedia, the free encyclopedia
 |
This page is considered a guideline on Wikipedia. It is generally accepted among editors and is considered a standard that all users should follow. However, it is not set in stone and should be treated with common sense and the occasional exception. When editing this page, please ensure that your revision reflects consensus. When in doubt, discuss first on the talk page. |
| Wikipedia Guidelines |
|---|
| Content |
| Autobiography Don't copy sources Disambiguation Hoaxes Patent nonsense |
| Classification |
| Subpages Cats, lists, boxes Lists Categories |
| Editing |
| Be Bold Build the web Edit summary Article size |
| Discussion |
| Talk page guidelines Sign on talk pages Build consensus |
| Behavior |
| Etiquette Profanity Don't disrupt Wikipedia to illustrate a point Don't bite the newcomers User page |
| Style |
| Manual of style
See also policies |
- For general information on creating lists see Help:List.
Contents |
[edit] Purpose of lists
Lists have three main purposes:
- Information
- The list may be a valuable information source. This is particularly the case for a structured list. Examples would include lists organized chronologically, grouped by theme, or annotated lists.
- Navigation
- Lists can be used as a table of contents, or if the user is browsing without a specific research goal in mind, they would likely use the See also lists. If the user has a specific research goal in mind, and there is only one or two words that are used to describe the research topic, and they know exactly how to spell the word, they would probably use the search engine box. If the user has some general idea of what they are looking for but does not know the specific terminology, they would tend to use the lists of related topics (also called list of links to related articles).
- Development
- Some lists are useful for Wikipedia development purposes. The lists of related topics give an indication of the state of the 'pedia, the articles that have been written, and the articles that have yet to be written.
Like categories, lists can be used for keeping track of changes in the listed pages, using the Related Changes feature. Unlike a category, a list also allows detection of deletion of pages from it, and, more generally, a history of its contents is available.
[edit] List naming and list contents
- See also: Wikipedia:Lists in Wikipedia
The contents of a list should be obvious. If the title does not already clarify what the list includes, then the list's lead section should do so. Don't leave editors guessing what can be added to the list.
[edit] List title
For a stand-alone list the list's title is the page name. For an embedded list, the list's title is usually a section title (for instance Latin Empire#Latin Emperors of Constantinople, 1204–1261), but it can be shorter, see for example Streamlined style or horizontal style below.
A list's title should be as clear and unambiguous as possible, as it reports the contents of the list. But sometimes this is not possible, as when the name of the subject is itself misleading or ambiguous. In such a case, the lead section should remedy this problem (see below).
For a navigational template used as an embedded list (often called "series box", see for example {{IsaacNewtonSegments}}, {{Princess Royal}},...):
- Make the title section stand out with an appropriate background color (see {{Navbox generic}}).
- Make the title link to the "main" or summary style article of the series.
[edit] Lead section
Stand-alone lists are a type of article. All articles should include a lead section, and stand-alone lists are no exception. Even when the meaning of the page's title seems obvious, a lead section should be provided which briefly and clearly describes the list.
If the meaning of the list's title seems obvious, e.g. List of dog breeds, the article may open with a simple statement using wikilinks, e.g. "This is a list of dog breeds." If the list's title does not seem obvious, e.g. List of scholastic philosophers, the lead section should clarify the meaning of the title, e.g. "This is a list of philosophers working in the Christian tradition in Western Europe during the medieval period. See also scholasticism."
However short or schematic a list description, Wikipedia:Neutral point of view applies, including:
It should not be asserted that the most popular view or some sort of intermediate view among the different views is the correct one.
Non-obvious characteristics of the list, for instance regarding the list structure, should also be explained in the lead section. For example, the lead section of the list enclosed in {{Princess Royal}} explains "dates they were Princess Royal in brackets".
Embedded lists don't always have a lead section, but should in cases where the title is ambiguous or when the list has non-obvious characteristics.
[edit] References for list Items
Lists should always include unambiguous statements of membership criteria based on definitions made by reputable sources, especially in difficult or contentious topics. Beware of those cases in which the definitions themselves are disputed. Many lists on Wikipedia have been created without any membership criteria, and editors are left to guess about what or whom should be included only from the name of the list. Even if it might "seem obvious" what qualifies for membership in a list, explicit is better than implicit.'
The policy Wikipedia:Verifiability states that "articles should contain only material that has been published by reputable sources. Editors should therefore provide references." The responsibility for providing a citation rests "with the editors who have made an edit or wish an edit to remain." Inclusion on the list should be based on what reliable sources say, not on what the editor interprets the source to be saying. In the case of edits lacking citations, according to Wikipedia:Verifiability:
Any edit lacking a source may be removed, but some editors may object if you remove material without giving people a chance to provide references. If you want to request a source for an unsourced statement, a good idea is to move it to the talk page. Alternatively, you may tag the sentence by adding the {{fact}} template, or tag the article by adding {{not verified}} or {{unsourced}}. Also in that case it may be helpful for your co-editors to leave a clarifying note on the talk page, for instance indicating which sources you already checked. You can also make the unsourced sentences invisible in the article by adding <!-- before the section you want to comment out and --> after it, until reliable sources have been provided. When using this "commenting out" technique it is usually best to leave a clarifying note on the talk page.
However, in lists that involve living persons, the following policy related to Biographies of living persons applies:
Be very firm about high quality references, particularly about details of personal lives. Unsourced or poorly sourced negative material about living persons should be removed immediately from both the article and the talk page. These principles also apply to biographical material about living persons in other articles.
[edit] List styles
There are four common ways of presenting lists on Wikipedia:
[edit] Unordered (bullet) lists
The format is:
== Title of list == * Example 1 * Example 2 * Example 3
[edit] Title of list
- Example 1
- Example 2
- Example 3
As a matter of style, list items should start with a capital letter. They should not have a punctuation mark such as a period, a comma or a semi-colon at the end, except if a list item is one or more full sentences, in which case there is a period at the end.
This style is appropriate for long lists, or lists of entries which consist of both a link and explanatory text. Also, it is appropriate when the article already has several titles and/or subtitles.
The Title provides a direct edit point, if one enables section editing. It also enables the automatic table of contents system to detect the list. It is not required, however.
Many Wikipedians feel this style is the easiest to read.
[edit] Ordered (numeric) lists
Similar to the above, use a # symbol to obtain a numbered list. The format is (note that to ensure sequential numbering, list items must not be separated by empty lines):
== Title of list == # Example 1 # Example 2 # Example 3
[edit] Title of list
- Example 1
- Example 2
- Example 3
[edit] Streamlined style or horizontal style
The format is:
''Title of list:'' example 1, example 2, example 3
Title of list: example 1, example 2, example 3
The style requires less space on the page, and is preferred if there are only a few entries in the list, it can be read easily, and a direct edit point is not required. The list items should start with a lowercase letter unless they are proper nouns.
[edit] Definition lists
The format is:
; Term 1 : Definition 1 ; Term 2 : Definition 2 ; Term 3 : Definition 3
- Term 1
- Definition 1
- Term 2
- Definition 2
- Term 3
- Definition 3
Use these real definition lists instead of fake ones like
* Term — Definition
- Term — Definition
or
* '''Term''': Definition
- Term: Definition
In many cases tables are better suited than definition lists.
[edit] Tables
Although the use of tables to display lists is discouraged (because it introduces unnecessarily complex code and makes editing difficult), there are some instances where they can be useful, such as when three, or more, columns are required. See Wikipedia:When to use tables
[edit] Types of lists
A list can stand alone as a self contained page, or it can be embedded in an article.
- Stand-alone lists, or "lists of links" are entries consisting of a list of links to articles in a particular subject area, such as people or places or a timeline of events. The titles of these entries always begin with List of or Timeline of. The title and bullet style or vertical style is common for this type of list. These Wikipedia entries follow the Wikipedia:Lists (stand-alone lists).
- Embedded lists are either included in the article or appended to the end of articles. They present information or aid in navigation to related articles. Some examples include: See also lists, Compare lists, Related topics lists, and Reference lists (also called External links). To see how to include a list in an article, go to Wikipedia:Lists (embedded lists)
[edit] Boilerplate text
Before or after an incomplete list, insert the following text which will be automatically substituted:
{{Incomplete-list}}
or
{{listdev}}
which produces:
[edit] See also
- Wikipedia:Lists (stand-alone lists)
- Wikipedia:Lists in Wikipedia
- Wikipedia:Embedded list
- Wikipedia:Manual of Style (lists of works)
- Wikipedia:Template messages/Lists
- Wikipedia:What is a featured list?
- Wikipedia:Manual of Style (disambiguation pages) — disambiguation pages are in fact "lists of homographs", with their own page layout specifics.
- Wikipedia:Listcruft
- Wikipedia:Categories, lists, and series boxes
- Wikipedia:Categories vs lists
- Wikipedia:List of lists — an automatically generated list of all lists on Wikipedia
- Wikia: Has Top 10 Lists available for wiki editing
