More actions
| (6 intermediate revisions by the same user not shown) | |||
| Line 62: | Line 62: | ||
===Definition lists=== | ===Definition lists=== | ||
A series of definitions should use proper formatting for [[ | A series of definitions should use proper formatting for [[UniWiki:Manual of Style/Lists#Definition lists|definition lists]]. Definition lists take more space, but are quicker for the reader to scan. Properly formatted definition lists are more [[UniWiki:Manual of Style/Accessibility|accessible]] to people using [[Wikipedia:Screen reader|screen readers]] and have a variety of technical benefits related to HTML validation, browser compatibility, and automatic implementation of future style changes. Do not leave blank lines between list items. | ||
The most typical reason for using a definition list is for | The most typical reason for using a definition list is for a glossary, in which case it is preferable to other formatting styles. Very large definition lists or lists of items whose definitions contain more than one paragraph may be better presented in other formats. Definition list formatting is occasionally used for other purposes, such as subdividing large sections (e.g., lengthy [[Wikipedia:WP:EL|External links]] or [[UniWiki:Manual of Style/Layout#Further reading|Further reading]] sections). | ||
{| class="wikitable" | {| class="wikitable" | ||
| Line 72: | Line 72: | ||
| width="50%" |<br> | | width="50%" |<br> | ||
<br> | <br> | ||
A ''disease'' is any abnormal condition that impairs normal function, especially [[infectious | A ''disease'' is any abnormal condition that impairs normal function, especially [[Wikipedia:Infectious disease|infectious diseases]], which are clinically evident diseases that result from the presence of [[Wikipedia:Pathogenic|pathogenic]] microbial agents. ''Illness'' or ''sickness'' are usually synonyms for ''disease'', except when used to refer specifically to the patient's personal experience of their disease. ''Medical condition'' is a broad term that includes all diseases and disorders, but can also include [[Wikipedia:Injuries|injuries]] and normal health situations, such as [[Wikipedia:Pregnancy|pregnancy]], that might affect a person's health, benefit from medical assistance, or have implications for medical treatments. | ||
| | | | ||
;Disease : Any abnormal condition that impairs normal function, especially [[infectious | ;Disease : Any abnormal condition that impairs normal function, especially [[Wikipedia:Infectious disease|infectious diseases]], which are clinically evident diseases that result from the presence of [[Wikipedia:Pathogenic|pathogenic]] microbial agents. | ||
;Illness or sickness : Synonyms for ''disease'', except when used to refer specifically to the patient's personal experience of their disease. | ;Illness or sickness : Synonyms for ''disease'', except when used to refer specifically to the patient's personal experience of their disease. | ||
;Medical condition : A broad term that includes all diseases and disorders, but can also include [[injuries]] and normal health situations, such as [[pregnancy]], that might affect a person's health, benefit from medical assistance, or have implications for medical treatments. | ;Medical condition : A broad term that includes all diseases and disorders, but can also include [[Wikipedia:Injuries|injuries]] and normal health situations, such as [[Wikipedia:Pregnancy|pregnancy]], that might affect a person's health, benefit from medical assistance, or have implications for medical treatments. | ||
|- | |- | ||
|} | |} | ||
===Lists of works and timelines=== | ===Lists of works and timelines=== | ||
{{See also | {{hatnote|See also: [[Wikipedia:Wikipedia:Timeline|Wikipedia:Timeline]]}} | ||
Lists of works of individuals or groups, such as bibliographies, discographies, filmographies, album personnel and track listings, as well as timelines or chronologies, are typically presented in simple list format, though it is expected that the information will be supported elsewhere in the article by prose analysis of the main points, and that if the lists become unwieldy, they are split off into stand-alone lists per [[WP:Summary style]] | Lists of works of individuals or groups, such as bibliographies, discographies, filmographies, album personnel and track listings, as well as timelines or chronologies, are typically presented in simple list format, though it is expected that the information will be supported elsewhere in the article by prose analysis of the main points, and that if the lists become unwieldy, they are split off into stand-alone lists per [[Wikipedia:WP:Summary style]]. Specific advice regarding timelines is given in [[Wikipedia:Wikipedia:Timeline standards|Wikipedia:Timeline standards]]. | ||
===Tables=== | ===Tables=== | ||
{{Main| | {{Main|UniWiki:Manual of Style/Tables}} | ||
Tables are a way of presenting links, data or information in rows and columns. They are a complex form of list. Tables might be used for presenting mathematical data such as multiplication tables, comparative figures, or sporting results. They might also be used for presenting equivalent words in two or more languages; for awards by type and year; complex discographies; etc. Consideration may be given to [[Help:Collapsing|collapsing]] tables which [[ | Tables are a way of presenting links, data or information in rows and columns. They are a complex form of list. Tables might be used for presenting mathematical data such as multiplication tables, comparative figures, or sporting results. They might also be used for presenting equivalent words in two or more languages; for awards by type and year; complex discographies; etc. Consideration may be given to [[Wikipedia:Help:Collapsing|collapsing]] tables which [[UniWiki:Manual of Style#Scrolling lists and collapsible content|consolidate information covered in the prose]]. | ||
=== Related topics (navigational lists) | === Related topics (navigational lists)=== | ||
{{ | {{hatnote|See also: {{section link|UniWiki:Manual of Style/Layout|"See also" section}} and [[Wikipedia:Wikipedia:Navigational templates|Wikipedia:Navigational templates]]}} | ||
{{ | |||
'''"See also" lists''' and '''"Related topics" lists''' are valuable navigational tools that assist users in finding related Wikipedia articles. When deciding what articles and lists of articles to append to any given entry, it is useful to try to put yourself inside the mind of readers: Ask yourself where would a reader likely want to go after reading the article. Typically this will include three types of links: | '''"See also" lists''' and '''"Related topics" lists''' are valuable navigational tools that assist users in finding related Wikipedia articles. When deciding what articles and lists of articles to append to any given entry, it is useful to try to put yourself inside the mind of readers: Ask yourself where would a reader likely want to go after reading the article. Typically this will include three types of links: | ||
* Links to related topics – topics similar to that discussed in the article. | * Links to related topics – topics similar to that discussed in the article. | ||
* Higher order (i.e. more general) articles and lists – this might include [[lists of people]], [[list of countries]], etc. For example, [[list of Indian language poets]] should link to both [[list of Indians]] and [[list of poets]]. | * Higher order (i.e. more general) articles and lists – this might include [[Wikipedia:Lists of people|lists of people]], [[Wikipedia:List of countries|list of countries]], etc. For example, [[Wikipedia:List of Indian language poets|list of Indian language poets]] should link to both [[Wikipedia:List of Indians|list of Indians]] and [[Wikipedia:List of poets|list of poets]]. | ||
* Lower order (i.e. more specific) articles and lists – for example, the [[Business]] page navigational list contains links to [[small business]], [[list of accounting topics]], etc. | * Lower order (i.e. more specific) articles and lists – for example, the [[Wikipedia:Business|Business]] page navigational list contains links to [[Wikipedia:Small business|small business]], [[Wikipedia:List of accounting topics|list of accounting topics]], etc. | ||
There is some controversy over how many links to articles and links to lists that should be put in any article. Some people separate the "links to articles" (put in the "See also" section) from the "links to lists" (put in the "Related topics" section), but this is not necessary unless there are too many links for one section alone. Some feel the optimum number of links to lists that should be included at the end of any given article is one or two (or fewer). Others feel that a more comprehensive set of lists would be useful. In general, we should use the same criteria when deciding what list to include as we use to decide what articles to include in the '''See also''' section. We have to try to put ourselves in the readers' frame of mind and ask "Where will I likely want to go after reading this article?". As a general rule, the "See also" section should '''not''' repeat links that appear in the article's body or its [[Wikipedia:Navigation templates|navigation boxes]]. | There is some controversy over how many links to articles and links to lists that should be put in any article. Some people separate the "links to articles" (put in the "See also" section) from the "links to lists" (put in the "Related topics" section), but this is not necessary unless there are too many links for one section alone. Some feel the optimum number of links to lists that should be included at the end of any given article is one or two (or fewer). Others feel that a more comprehensive set of lists would be useful. In general, we should use the same criteria when deciding what list to include as we use to decide what articles to include in the '''See also''' section. We have to try to put ourselves in the readers' frame of mind and ask "Where will I likely want to go after reading this article?". As a general rule, the "See also" section should '''not''' repeat links that appear in the article's body or its [[Wikipedia:Wikipedia:Navigation templates|navigation boxes]]. | ||
=== References and external links === | === References and external links === | ||
'''Reference lists''' show information sources outside of | '''Reference lists''' show information sources outside of the UniWiki. The two most common types are: | ||
* "Web hyperlinks" – lists of links to web addresses other than | * "Web hyperlinks" – lists of links to web addresses other than the UniWiki, under the heading "External links" | ||
* "References" – lists of academic journal articles or books, under the heading "References" | * "References" – lists of academic journal articles or books, under the heading "References" | ||
==Accessibility== | ==Accessibility== | ||
| Line 114: | Line 111: | ||
==Size== | ==Size== | ||
{{ | {{hatnote|See also: [[Wikipedia:Wikipedia:Article size#Lists, tables and summaries|Wikipedia:Article size#Lists, tables and summaries]]}} | ||
Consideration should be given to keeping embedded lists and tables as short as feasible for their purpose and scope: material within an embedded list should relate to the article topic without going into unnecessary detail; and statistical data kept to a minimum. | |||
Consideration should be given to keeping embedded lists and tables as short as feasible for their purpose and scope: material within an embedded list should relate to the article topic without going into unnecessary detail; and statistical data kept to a minimum | |||
Some material may [[Wikipedia: | Some material may [[Wikipedia:Wikipedia:Page size#Readability issues|not be appropriate]] for reducing or summarizing using the [[Wikipedia:WP:Summary style|summary style]] method. Consideration may be needed to either keep all the material embedded in the main article or split it off entirely into a sub-article. | ||
Some information, such as "Notable people" or "Alumni", which may be read for context or scanned for content, may be formatted with a section lead and a descriptive, bulleted list, or as prose, depending on size. If the list is long, is unable to be summarised, but is not appropriate for splitting out, then a section lead, with a descriptive, bulleted list may be more appropriate than a long prose section. | Some information, such as "Notable people" or "Alumni", which may be read for context or scanned for content, may be formatted with a section lead and a descriptive, bulleted list, or as prose, depending on size. If the list is long, is unable to be summarised, but is not appropriate for splitting out, then a section lead, with a descriptive, bulleted list may be more appropriate than a long prose section. | ||
| Line 124: | Line 120: | ||
== Bulleted and numbered lists == | == Bulleted and numbered lists == | ||
* Do not use lists if a passage is read easily as plain paragraphs. | * Do not use lists if a passage is read easily as plain paragraphs. | ||
* Use proper wikimarkup- or template-based list code ''(see [[ | * Use proper wikimarkup- or template-based list code ''(see [[UniWiki:Manual of Style/Lists]] and [[Wikipedia:Help:List]])''. | ||
* 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 | * 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 MediaWiki software to interpret each item as beginning a new list. | ||
* Use numbers rather than bullets only if: | * Use numbers rather than bullets only if: | ||
** a need to refer to the elements by number may arise; | ** a need to refer to the elements by number may arise; | ||