Difference between revisions of "UniWiki:Manual of Style/Disambiguation pages"

From EVE University Wiki
Jump to: navigation, search
m (Correct spelling errors)
 
(34 intermediate revisions by 3 users not shown)
Line 5: Line 5:
 
This style guideline is intended to make the search more efficient, by giving disambiguation pages a consistent look and by avoiding distracting information. In brief, the pages should contain only disambiguation content, whether or not the page title contains the parenthetical ''(disambiguation)''. (This guideline does not apply to articles that are [[Wikipedia:WP:PRIMARYTOPIC|primary topics]], even if the articles are prefaced by a "See also" hatnote or the like at the top of the page.)
 
This style guideline is intended to make the search more efficient, by giving disambiguation pages a consistent look and by avoiding distracting information. In brief, the pages should contain only disambiguation content, whether or not the page title contains the parenthetical ''(disambiguation)''. (This guideline does not apply to articles that are [[Wikipedia:WP:PRIMARYTOPIC|primary topics]], even if the articles are prefaced by a "See also" hatnote or the like at the top of the page.)
  
== Page naming ==
+
= Page naming =
  
 
In general, the title of a disambiguation page is the ambiguous term itself, provided there is no primary topic for that term. If there is already a primary topic, then "(disambiguation)" is added to the title of the disambiguation page, as in [[Wikipedia:Jupiter (disambiguation)|Jupiter (disambiguation)]]. For more on how to title a disambiguation page, see [[Wikipedia:Wikipedia:Disambiguation#Naming the disambiguation page|Wikipedia:Naming the disambiguation page]].
 
In general, the title of a disambiguation page is the ambiguous term itself, provided there is no primary topic for that term. If there is already a primary topic, then "(disambiguation)" is added to the title of the disambiguation page, as in [[Wikipedia:Jupiter (disambiguation)|Jupiter (disambiguation)]]. For more on how to title a disambiguation page, see [[Wikipedia:Wikipedia:Disambiguation#Naming the disambiguation page|Wikipedia:Naming the disambiguation page]].
  
==At the top of the page==
+
= At the top of the page =
 
The first line of a disambiguation page should be the '''introductory line''' ([[#Introductory line|see below]]). If there is a link to the '''primary topic''' ([[#Linking to a primary topic|see below]]), that line should appear before the introductory line. Both of these should begin its own line.
 
The first line of a disambiguation page should be the '''introductory line''' ([[#Introductory line|see below]]). If there is a link to the '''primary topic''' ([[#Linking to a primary topic|see below]]), that line should appear before the introductory line. Both of these should begin its own line.
  
=== Linking to a primary topic ===
+
== Linking to a primary topic ==
{{shortcut|MOS:DABPRIMARY}}
 
When a page has "(disambiguation)" in its title – i.e., it is the disambiguation page for a term for which a primary topic has been identified – users are most likely to arrive there by clicking on a top link from the primary topic article, generated by a template in the {{tlx|otheruses}} series. For example, the article [[School]] contains the [[Wikipedia:Hatnote|hatnote]]:
 
{{other uses2|School}}
 
  
The primary topic is the one reached by using the disambiguation page title without the (disambiguation) qualifier. Capitalisation differences matter, so there will only be one primary topic for a title.  
+
When a page has "(disambiguation)" in its title – i.e., it is the disambiguation page for a term for which a primary topic has been identified – users are most likely to arrive there by clicking on a top link from the primary topic article.
 +
 
 +
The primary topic is the one reached by using the disambiguation page title without the (disambiguation) qualifier. Capitalization differences matter, so there will only be one primary topic for a title.  
  
 
Since it is unlikely that this primary topic is what readers are looking for if they have reached the disambiguation page, it should not be mixed in with the other links. It is recommended that the link back to the primary topic appear at the top, in a brief explanatory sentence. For instance:
 
Since it is unlikely that this primary topic is what readers are looking for if they have reached the disambiguation page, it should not be mixed in with the other links. It is recommended that the link back to the primary topic appear at the top, in a brief explanatory sentence. For instance:
Line 24: Line 23:
 
|-
 
|-
 
|
 
|
A '''[[school]]''' is an institution for learning.
+
A '''[[Wikipedia:School|school]]''' is an institution for learning.
  
 
'''School''' may also refer to:
 
'''School''' may also refer to:
* [[School of thought]], a number of individuals with shared styles, approaches or aims
+
* [[Wikipedia:School of thought|School of thought]], a number of individuals with shared styles, approaches or aims
* [[School (fish)]], a group of fish swimming in the same direction in a coordinated manner
+
* [[Wikipedia:School (fish)|School (fish)]], a group of fish swimming in the same direction in a coordinated manner
 
* . . .
 
* . . .
 
|}
 
|}
Line 35: Line 34:
 
:{| style="border: 1px solid black" width=80%
 
:{| style="border: 1px solid black" width=80%
 
|-
 
|-
|A '''[[cosmonaut]]''' or astronaut is a person trained by a human spaceflight program to command, pilot, or serve as a crew member of a spacecraft.
+
|A '''[[Wikipedia:Cosmonaut|cosmonaut]]''' or astronaut is a person trained by a human spaceflight program to command, pilot, or serve as a crew member of a spacecraft.
 
|}
 
|}
  
Line 41: Line 40:
 
:{| style="border: 1px solid black" width=80%
 
:{| style="border: 1px solid black" width=80%
 
|-
 
|-
|'''[[CIA]]''' is the Central Intelligence Agency, a civilian agency of the United States government.
+
|'''[[Wikipedia:CIA|CIA]]''' is the Central Intelligence Agency, a civilian agency of the United States government.
 
|}
 
|}
  
Line 47: Line 46:
 
:{| style="border: 1px solid black" width=80%
 
:{| style="border: 1px solid black" width=80%
 
|-
 
|-
|'''[[Wolfgang Amadeus Mozart]]''' (1756–1791) was a famous composer during the Classical period.
+
|'''[[Wikipedia:Wolfgang Amadeus Mozart|Wolfgang Amadeus Mozart]]''' (1756–1791) was a famous composer during the Classical period.
 
|}
 
|}
 
instead of the more awkward
 
instead of the more awkward
 
:{| style="border: 1px solid black" width=80%
 
:{| style="border: 1px solid black" width=80%
 
|-
 
|-
|<s>'''[[Mozart]]''' was Wolfgang Amadeus Mozart (1756–1791), a famous composer during the Classical period.</s>
+
|<s>'''[[Wikipedia:Mozart|Mozart]]''' was Wolfgang Amadeus Mozart (1756–1791), a famous composer during the Classical period.</s>
 
|}
 
|}
  
=== Introductory line ===
+
== Introductory line ==
{{shortcut|MOS:DABINT}}
+
:''See also: [[Wikipedia:Wikipedia:Template messages/General#In introductory lines|Wikipedia:Template messages#In introductory lines]]''
{{see also|WP:Template messages/General#In introductory lines}}
+
 
 
The term being disambiguated should be in '''bold''' (not ''italics''). It should begin a sentence fragment ending with a colon, introducing a bulleted list:
 
The term being disambiguated should be in '''bold''' (not ''italics''). It should begin a sentence fragment ending with a colon, introducing a bulleted list:
  
Line 97: Line 96:
 
However, it is not necessary to mention minor variations of capitalization, punctuation or diacritics. For example, {{xt|'''AU''' may refer to:}} is preferable to "'''AU''', '''au''', '''Au''' or '''A-U''' may refer to"; and {{xt|'''Saiyuki''' may refer to:}} is preferable to "'''Saiyuki''', '''Saiyūki''' or '''Saiyûki''' may refer to".
 
However, it is not necessary to mention minor variations of capitalization, punctuation or diacritics. For example, {{xt|'''AU''' may refer to:}} is preferable to "'''AU''', '''au''', '''Au''' or '''A-U''' may refer to"; and {{xt|'''Saiyuki''' may refer to:}} is preferable to "'''Saiyuki''', '''Saiyūki''' or '''Saiyûki''' may refer to".
  
== Individual entries ==
+
= Individual entries =
{{shortcut|MOS:DABENTRY|MOS:DABENTRIES}}
+
 
 
After the introductory line comes a list of individual entries&nbsp;– lines which direct the readers to Wikipedia articles on the various topics which might be referenced by the term being disambiguated. Keep in mind that the primary purpose of the disambiguation page is to help people find the specific article they want quickly and easily.
 
After the introductory line comes a list of individual entries&nbsp;– lines which direct the readers to Wikipedia articles on the various topics which might be referenced by the term being disambiguated. Keep in mind that the primary purpose of the disambiguation page is to help people find the specific article they want quickly and easily.
  
Line 106: Line 105:
 
|-
 
|-
 
|'''Interval''' may refer to:
 
|'''Interval''' may refer to:
* [[Interval (mathematics)]], a certain subset of an ordered set
+
* [[Wikipedia:Interval (mathematics)|Interval (mathematics)]], a certain subset of an ordered set
* [[Interval (music)]], the relationship between two notes
+
* [[Wikipedia:Interval (music)|Interval (music)]], the relationship between two notes
 
* ...
 
* ...
 
|}
 
|}
  
 
Apply the following rules when constructing entries:
 
Apply the following rules when constructing entries:
* Preface each entry with a {{em|bullet}} (an asterisk in wiki markup).  
+
* Preface each entry with a ''bullet'' (an asterisk in wiki markup).  
* Start each entry with a {{em|capital letter}} (unless it begins with a link to an article marked with {{tlx|lowercase}}, like [[eBay]]).
+
* Start each entry with a ''capital letter''.
* Insert a {{em|comma}} after an entry when a description is included.
+
* Insert a ''comma'' after an entry when a description is included.
* Use {{em|sentence fragments}}, with no closing punctuation unless it is part of the description (e.g., a description that ends in "etc." would end with the period)
+
* Use ''sentence fragments'', with no closing punctuation unless it is part of the description (e.g., a description that ends in "etc." would end with the period)
{{Anchor|onelinkonly}}
 
 
* Include '''exactly one''' navigable (blue) link to efficiently guide readers to the most relevant article for that use of the ambiguous term. '''Do not wikilink any other words in the line'''. For example:  
 
* Include '''exactly one''' navigable (blue) link to efficiently guide readers to the most relevant article for that use of the ambiguous term. '''Do not wikilink any other words in the line'''. For example:  
  
Line 122: Line 120:
 
|-
 
|-
 
|
 
|
* [[Dark Star (song)|"Dark Star" (song)]], by the Grateful Dead
+
* [[Wikipedia:Dark Star (song)|"Dark Star" (song)]], by the Grateful Dead
but {{em|not}}:
+
but ''not'':
* <s>[[Dark Star (song)|"Dark Star" (song)]], a [[song]] by the [[psychedelic]] [[rock band]] [[The Grateful Dead]]</s>
+
* <s>[[Wikipedia:Dark Star (song)|"Dark Star" (song)]], a [[Wikipedia:Song|song]] by the [[Wikipedia:Psychedelic|psychedelic]] [[Wikipedia:Rock band|rock band]] [[Wikipedia:The Grateful Dead|The Grateful Dead]]</s>
 
and avoid redundancies like:
 
and avoid redundancies like:
* [[Dark Star (song)|"Dark Star" (song)]], a song by the Grateful Dead
+
* [[Wikipedia:Dark Star (song)|"Dark Star" (song)]], a song by the Grateful Dead
 
|}
 
|}
* Do not emphasize the link with bolding or italics, although titles (such as for books and movies) may need to be italicized to conform with the [[Wikipedia:Manual of Style/Titles|style guidance on titles]]. If the article's title contains both a title and a clarifier, quote or italicize only the part requiring such treatment, as opposed to the entire link, e.g.: [[Dark Star (film)|''Dark Star'' (film)]] (see {{section link||Piping and redirects}}). This can be accomplished by [[Wikipedia:Piped link|piping]] the link. The templates {{tl|fti}} or {{tl|ftq}} can also be used to put only the title, and not the qualifier, in italics or quotes, respectively.
+
* Do not emphasize the link with bolding or italics, although titles (such as for books and movies) may need to be italicized to conform with the [[UniWiki:Manual of Style/Titles|style guidance on titles]]. If the article's title contains both a title and a clarifier, quote or italicize only the part requiring such treatment, as opposed to the entire link, e.g.: [[Wikipedia:Dark Star (film)|''Dark Star'' (film)]] (see {{section link||Piping and redirects}}). This can be accomplished by [[Wikipedia:Wikipedia:Piped link|piping]] the link.
* {{anchor|terse}}Keep the description associated with a link to a minimum, just sufficient to allow the reader to find the correct link. In many cases, the title of the article alone will be sufficient and no additional description is necessary.<!-- The thinking behind keeping description to a minimum is: it is only for helping the reader find the right link; being on an obscure page, it will not be used for reference, and will not be well maintained. -->
+
* Keep the description associated with a link to a minimum, just sufficient to allow the reader to find the correct link. In many cases, the title of the article alone will be sufficient and no additional description is necessary.
  
 
In most cases the title of the target article will be an expansion or variation of the term being disambiguated (as in the example above). If this is the case:
 
In most cases the title of the target article will be an expansion or variation of the term being disambiguated (as in the example above). If this is the case:
 
*The link should come at the start of the entry.
 
*The link should come at the start of the entry.
*The article title should appear exactly as it is on the target page; the link should not be [[Wikipedia:Piped link|piped]] except to apply formatting (see {{section link||Where piping may be appropriate}}).
+
*The article title should appear exactly as it is on the target page; the link should not be [[Wikipedia:Wikipedia:Piped link|piped]] except to apply formatting (see {{section link||Where piping may be appropriate}}).
  
In some cases, however, the target article title is {{em|not}} an expansion or variation of the term being disambiguated.{{clarify|reason=an example would be helpful}} For these cases see {{section link||Red links|Items appearing within other articles}} below.
+
In some cases, however, the target article title is ''not'' an expansion or variation of the term being disambiguated. For these cases see {{section link||Red links}} and {{section link||Items appearing within other articles}} below.
  
 
Note also the following points when constructing lists of entries:  
 
Note also the following points when constructing lists of entries:  
 
* An entry with no links at all is useless for further navigation. (See {{section link||Red links}} for cases in which no article yet exists.)
 
* An entry with no links at all is useless for further navigation. (See {{section link||Red links}} for cases in which no article yet exists.)
 
* A disambiguation page should not be made up completely of red links or have only one blue link on the entire page, because the basic purpose of disambiguation is to refer users to other Wikipedia pages.  
 
* A disambiguation page should not be made up completely of red links or have only one blue link on the entire page, because the basic purpose of disambiguation is to refer users to other Wikipedia pages.  
* {{anchor|extlinks}}Never include [[Help:External links|external links]], either as entries or in descriptions. Disambiguation pages disambiguate Wikipedia articles, not the World-Wide Web. To note URLs that might be helpful in the future, include them on the talk page.
+
* Never include [[Wikipedia:Help:External links|external links]], either as entries or in descriptions. Disambiguation pages disambiguate Wikipedia articles, not the World-Wide Web. To note URLs that might be helpful in the future, include them on the talk page.
* [[WP:REF|References]] should not appear on disambiguation pages. Dab pages are not articles; instead, incorporate the references into the target articles.
+
* [[Wikipedia:WP:REF|References]] should not appear on disambiguation pages. Dab pages are not articles; instead, incorporate the references into the target articles.
  
=== <span id="Specific_instances" ></span>Examples of individual entries that should not be created ===
+
== Examples of individual entries that should not be created ==
{{shortcut|MOS:DABNOENTRY}}
+
:''See also: [[Wikipedia:Wikipedia:Disambiguation#What not to include|Wikipedia:Disambiguation#What not to include]]''
{{further information|Wikipedia:Disambiguation#What not to include}}
 
Do not include entries for topics that are not ambiguous (according to the linked article) with the title. Use [[Wikipedia:Lists|list articles]] for lists of related topics if needed.
 
  
On a page called {{var|Title}}, do not create entries merely because {{var|Title}} is part of the name (see {{section link|Wikipedia:Disambiguation|Partial title matches}}).
+
Do not include entries for topics that are not ambiguous (according to the linked article) with the title. Use [[Wikipedia:Wikipedia:Lists|list articles]] for lists of related topics if needed.
 +
 
 +
On a page called ''Title'', do not create entries merely because ''Title'' is part of the name (see [[Wikipedia:Wikipedia:Disambiguation#Partial title matches|Wikipedia:Disambiguation &sect; Partial title matches]]).
  
 
Common examples:
 
Common examples:
  
* {{var|Title}} City
+
* ''Title'' City
* {{var|Title}} Hospital
+
* ''Title'' Hospital
* {{var|Title}} University
+
* ''Title'' University
  
The above does not apply if the subject is commonly referred to simply by {{var|Title}}. For instance, [[Oxford (disambiguation)]] should link to [[University of Oxford]] and [[Catalina]] might include [[Santa Catalina Island, California]]. If there is disagreement about whether this exception applies, it is often best to assume that it does. When multiple articles contain {{var|Title}} but are not referred to by it, {{tlx|look from}} and {{tlx|in title}} templates may be added in the [[#Ordering|"See also" section]].
+
The above does not apply if the subject is commonly referred to simply by ''Title''. For instance, [[Wikipedia:Oxford (disambiguation)|Oxford (disambiguation)]] should link to [[Wikipedia:University of Oxford|University of Oxford]] and [[Wikipedia:Catalina|Catalina]] might include [[Wikipedia:Santa Catalina Island, California|Santa Catalina Island, California]]. If there is disagreement about whether this exception applies, it is often best to assume that it does.
  
 
You may want to create entries on the same page for:
 
You may want to create entries on the same page for:
* {{var|TITLE}} and {{var|Title}}
+
* ''TITLE'' and ''Title''
* {{var|Title}} town and {{var|Title}} township
+
* ''Title'' town and ''Title'' township
** An example is [[Willow Valley]], which lists a town of that name as well as "Willow Valley Township" in another state.
+
** An example is [[Wikipedia:Willow Valley|Willow Valley]], which lists a town of that name as well as "Willow Valley Township" in another state.
 
 
=== Given names or surnames ===
 
{{shortcut|MOS:DABNAME|WP:DABSUR}}
 
{{Redirect|MOS:DABNAME|the guideline regarding how to name disambiguation pages|Wikipedia:Disambiguation#Naming the disambiguation page}}
 
{{main article|Wikipedia:WikiProject Anthroponymy}}
 
 
 
Persons who have the ambiguous term as surname or given name should be listed in the body of the disambiguation page if they are frequently referred to simply by the single name (e.g., [[Elvis]], [[Shakespeare]]). For short lists of name holders, new sections of ''Persons with the surname Xxxx'' or ''Persons with the given name Xxxx'' can be added below the main disambiguation list. For longer lists, create an [[Wikipedia:WikiProject Anthroponymy/Standards|anthroponymy list article]] and link to it from the disambiguation page.  If it isn't clear that the article includes a list, consider mentioning that in the description.  
 
  
For example:
+
== Misspellings ==
*[[Marilyn (given name)]], a female given name (including a list of persons with the name)
+
Common misspellings should be listed only if there is a genuine risk of confusion or misspelling. These cross-links should be placed in a separate section entitled "Common misspellings" or "See also". For example, in a page called [[Wikipedia:Kington (disambiguation)|Kington (disambiguation)]], a link to [[Wikipedia:Kingston (disambiguation)|Kingston (disambiguation)]] would appropriately be included in the "See also" section.
*[[Dylan (name)]], a given name and a family name (including a list of persons with the name)
 
  
Articles {{em|only}} listing persons with a certain given name or surname, known as anthroponymy articles, are {{em|not}} disambiguation pages, and this Manual of Style does not apply to them.  Anthroponymy articles follow [[Wikipedia:WikiProject Anthroponymy/Standards|their own style standards]].  For those articles, do {{em|not}} use {{tlx|disambig}} or {{tlx|hndis}}, but {{tlx|given name}} or {{tlx|surname}} instead.
+
==Piping and redirects==
  
=== Misspellings ===
 
Common misspellings should be listed only if there is a genuine risk of confusion or misspelling. These cross-links should be placed in a separate section entitled "Common misspellings" or "See also". For example, in a page called [[Kington (disambiguation)]], a link to [[Kingston (disambiguation)]] would appropriately be included in the "See also" section.
 
 
==={{anchor|Piping}}Piping and redirects===
 
<!-- This Anchor tag serves to provide a permanent target for incoming section links. Please do not move it out of the section heading, even though it disrupts edit summary generation (you can manually fix the edit summary before saving your changes). Please do not modify it, even if you modify the section title. It is always best to anchor an old section header that has been changed so that links to it won't be broken. See [[Template:Anchor]] for details. (This text: [[Template:Anchor comment]]) -->
 
{{shortcut|MOS:DABPIPE|WP:DABPIPE}}
 
 
Piping and redirects are two different mechanisms which allow the displayed text of a link to differ from the title of the page that the link points to.
 
Piping and redirects are two different mechanisms which allow the displayed text of a link to differ from the title of the page that the link points to.
* ''[[Wikipedia:Piped link|Piping]]'' means concealing the title of a linked article by replacing it with other text.  For example, instead of showing the full title [[Moment (physics)]], it may be presented as <code><nowiki>[[Moment (physics)|moment]]</nowiki></code>, resulting in the link [[Moment (physics)|moment]].
+
* ''[[Wikipedia:Wikipedia:Piped link|Piping]]'' means concealing the title of a linked article by replacing it with other text.  For example, instead of showing the full title [[Wikipedia:Moment (physics)|Moment (physics)]], it may be presented as <code><nowiki>[[Moment (physics)|moment]]</nowiki></code>, resulting in the link [[Wikipedia:Moment (physics)|moment]].
* A ''[[WP:REDIRECT|redirect]]'' is a page used to "jump" readers from one page title to an article with a different title. For example, a redirect at the title [[9/11]] sends users who navigate there to the article [[September 11 attacks]].
+
* A ''[[Wikipedia:WP:REDIRECT|redirect]]'' is a page used to "jump" readers from one page title to an article with a different title. For example, a redirect at the title [[Wikipedia:9/11|9/11]] sends users who navigate there to the article [[Wikipedia:September 11 attacks|September 11 attacks]].
  
 
Piping and redirects should not generally be used on disambiguation pages, ''except as described below''.
 
Piping and redirects should not generally be used on disambiguation pages, ''except as described below''.
  
'''Subject to certain exceptions as listed below, piping or redirects should not be used in disambiguation pages'''. This is to make it clear to the reader which topic is the subject of an article title. For example, on the disambiguation page [[Moment]], in the entry [[Moment (physics)]], "&nbsp;(physics)" should be visible so that the reader sees which "moment" topic the entry is about, among others sharing the same base title. In many cases, what would be hidden by a pipe is exactly what the user would need in order to find their intended article. However, raw section and anchor points should not be displayed; see {{section link||Section and anchor point linking}} for those cases.
+
'''Subject to certain exceptions as listed below, piping or redirects should not be used in disambiguation pages'''. This is to make it clear to the reader which topic is the subject of an article title. For example, on the disambiguation page [[Wikipedia:Moment|Moment]], in the entry [[Wikipedia:Moment (physics)|Moment (physics)]], "&nbsp;(physics)" should be visible so that the reader sees which "moment" topic the entry is about, among others sharing the same base title. In many cases, what would be hidden by a pipe is exactly what the user would need in order to find their intended article. However, raw section and anchor points should not be displayed; see {{section link||Section and anchor point linking}} for those cases.
  
 
Though piping and redirects should generally not be used in disambiguation pages, there are certain cases in which they may be useful to the reader:
 
Though piping and redirects should generally not be used in disambiguation pages, there are certain cases in which they may be useful to the reader:
  
=====Where redirecting may be appropriate=====
+
===Where redirecting may be appropriate===
{{shortcut|MOS:DABREDIR|WP:DABREDIR}}
+
 
 
*A redirect should be used to link to a specific section of an article if the title of that section is more or less synonymous with the disambiguated topic. This indicates a higher possibility that the topic may eventually have its own article.  For example:
 
*A redirect should be used to link to a specific section of an article if the title of that section is more or less synonymous with the disambiguated topic. This indicates a higher possibility that the topic may eventually have its own article.  For example:
 
:{| style="border: 1px solid black" width=80%
 
:{| style="border: 1px solid black" width=80%
 
|-
 
|-
 
|'''Delta''' may refer to:
 
|'''Delta''' may refer to:
* (correct) [[Delta Quadrant]], in the ''Star Trek'' universe<br />Markup: <code><nowiki>[[Delta Quadrant]], in the ''Star Trek'' universe</nowiki></code>
+
* (correct) [[Wikipedia:Delta quadrant|Delta Quadrant]], in the ''Star Trek'' universe<br />Markup: <code><nowiki>[[Delta Quadrant]], in the ''Star Trek'' universe</nowiki></code>
* (incorrect) [[Galactic quadrant (Star Trek)#Delta Quadrant|Delta Quadrant]], in the ''Star Trek'' universe<br />Markup: <code><nowiki>[[Galactic quadrant (Star Trek)#Delta Quadrant|Delta Quadrant]], in the ''Star Trek'' universe</nowiki></code>
+
* (incorrect) [[Wikipedia:Galactic quadrant (Star Trek)#Delta Quadrant|Delta Quadrant]], in the ''Star Trek'' universe<br />Markup: <code><nowiki>[[Galactic quadrant (Star Trek)#Delta Quadrant|Delta Quadrant]], in the ''Star Trek'' universe</nowiki></code>
* (incorrect) Delta Quadrant, in the [[Galactic quadrant (Star Trek)#Delta Quadrant|Galactic quadrant of the ''Star Trek'']] universe<br />Markup: <code><nowiki>Delta Quadrant, in the [[Galactic quadrant (Star Trek)#Delta Quadrant|Galactic quadrant of the ''Star Trek'']] universe</nowiki></code>
+
* (incorrect) Delta Quadrant, in the [[Wikipedia:Galactic quadrant (Star Trek)#Delta Quadrant|Galactic quadrant of the ''Star Trek'']] universe<br />Markup: <code><nowiki>Delta Quadrant, in the [[Galactic quadrant (Star Trek)#Delta Quadrant|Galactic quadrant of the ''Star Trek'']] universe</nowiki></code>
 
|}
 
|}
  
 
: The above technique is used when the link is the subject of the line. For description sections, redirects or piped links may be used; follow the normal [[Wikipedia:Redirect]] and [[Wikipedia:Piped link]] guidelines.
 
: The above technique is used when the link is the subject of the line. For description sections, redirects or piped links may be used; follow the normal [[Wikipedia:Redirect]] and [[Wikipedia:Piped link]] guidelines.
 
* Linking to a redirect can  also be helpful when both:
 
* Linking to a redirect can  also be helpful when both:
:#the redirect target article contains the disambiguated term; {{em|and}}
+
:#the redirect target article contains the disambiguated term; ''and''
 
:#the redirect could serve as an alternative name for the target article, meaning an alternative term that is already in the article's lead section.
 
:#the redirect could serve as an alternative name for the target article, meaning an alternative term that is already in the article's lead section.
 
:For example:
 
:For example:
Line 211: Line 195:
 
|-
 
|-
 
|'''James Cary''' may refer to:
 
|'''James Cary''' may refer to:
* (correct) [[James Carrey]] or Jim Carrey (born 1962), Canadian actor<br />Markup: <code><nowiki>[[James Carrey]] or Jim Carrey (born 1962), Canadian actor</nowiki></code>
+
* (correct) [[Wikipedia:James Carrey|James Carrey]] or Jim Carrey (born 1962), Canadian actor<br />Markup: <code><nowiki>[[James Carrey]] or Jim Carrey (born 1962), Canadian actor</nowiki></code>
* (incorrect) James Carrey or [[Jim Carrey]] (born 1962), Canadian actor<br />Markup: <code><nowiki>James Carrey or [[Jim Carrey]] (born 1962), Canadian actor</nowiki></code>
+
* (incorrect) James Carrey or [[Wikipedia:Jim Carrey|Jim Carrey]] (born 1962), Canadian actor<br />Markup: <code><nowiki>James Carrey or [[Jim Carrey]] (born 1962), Canadian actor</nowiki></code>
 
|}
 
|}
  
: The above example of a redirect is only appropriate because '''James Carrey''' is indicated as a name in the lead section of the [[Jim Carrey]] article.  If it were not, then the second example could have been used instead.
+
: The above example of a redirect is only appropriate because '''James Carrey''' is indicated as a name in the lead section of the [[Wikipedia:Jim Carrey|Jim Carrey]] article.  If it were not, then the second example could have been used instead.
:* However, when the disambiguated term is an [[Acronym and initialism|acronym or initialism (alphabetism)]], links should {{em|not}} use redirects to conceal the expanded version of that initialism. For example, on the disambiguation page [[BNL]], linking to the full article title [[Banca Nazionale del Lavoro]] is preferable to linking to a redirect at [[BNL (bank)]].
+
:* However, when the disambiguated term is an [[Wikipedia:Acronym and initialism|acronym or initialism (alphabetism)]], links should ''not'' use redirects to conceal the expanded version of that initialism. For example, on the disambiguation page [[Wikipedia:BNL|BNL]], linking to the full article title [[Wikipedia:Banca Nazionale del Lavoro|Banca Nazionale del Lavoro]] is preferable to linking to a redirect at [[Wikipedia:BNL (bank)|BNL (bank)]].
 
* Redirecting may be appropriate where the ''primary topic'' is a redirect; see {{section link||Linking to a primary topic}}.
 
* Redirecting may be appropriate where the ''primary topic'' is a redirect; see {{section link||Linking to a primary topic}}.
* Redirecting may be appropriate when linking to [[WP:INTDABLINK|another disambiguation page]].
+
* Redirecting may be appropriate when linking to [[Wikipedia:WP:INTDABLINK|another disambiguation page]].
  
=====Where piping may be appropriate=====
+
===Where piping may be appropriate===
{{shortcut|MOS:DABPIPING|WP:DABPIPING}}
+
 
* Use piping to add italics or quotation marks to part of an article name; for instance, [[Harvey (film)|''Harvey'' (film)]], [[USS Adder (SS-3)|USS ''Adder'' (SS-3)]], [[Route 66 (song)|"Route 66" (song)]], [[Saturnalia (dinosaur)|''Saturnalia'' (dinosaur)]], [[Hush (Buffy episode)|"Hush" (''Buffy'' episode)]], [[Neo (The Matrix)|Neo (''The Matrix'')]]. The templates {{tl|fti}} and {{tl|ftq}} may be used to create properly formatted links. These should be [[WP:Substitution|substituted]], since templates are discouraged on disambiguation pages (see {{section link||Images and templates}} below).
+
* Use piping to add italics or quotation marks to part of an article name; for instance, [[Wikipedia:Harvey (film)|''Harvey'' (film)]], [[Wikipedia:USS Adder (SS-3)|USS ''Adder'' (SS-3)]], [[Wikipedia:Route 66 (song)|"Route 66" (song)]], [[Wikipedia:Saturnalia (dinosaur)|''Saturnalia'' (dinosaur)]], [[Wikipedia:Hush (Buffy episode)|"Hush" (''Buffy'' episode)]], [[Wikipedia:Neo (The Matrix)|Neo (''The Matrix'')]].
** [[Wikipedia:WikiProject Disambiguation/Title templates]] for song, album and film title links
+
* Similarly, use piping if the entry's article title differs from how it should actually be rendered, due to [[Wikipedia:Template:Correct title|technical limitations]]; for instance, ''[[Wikipedia:The Singles 86–98|The Singles 86>98]]'' or [[Wikipedia:Softimage XSI|Softimage&#124;XSI]].
** [[Wikipedia:WikiProject Ships/Tools]] for ship and ship classes links
 
* Similarly, use piping if the entry's article title differs from how it should actually be rendered, due to [[Template:Correct title|technical limitations in Wikipedia]]; for instance, ''[[The Singles 86–98|The Singles 86>98]]'' or [[Softimage XSI|Softimage&#124;XSI]].
 
 
* When the link is part of the description, rather than the actual entry name, piping can be used more freely. However, the text of the link should still be very similar to the title of the target article, to avoid confusing the reader. For example:
 
* When the link is part of the description, rather than the actual entry name, piping can be used more freely. However, the text of the link should still be very similar to the title of the target article, to avoid confusing the reader. For example:
 
:{| style="border: 1px solid black" width=80%
 
:{| style="border: 1px solid black" width=80%
Line 231: Line 213:
 
|
 
|
 
'''Switch''' may refer to:
 
'''Switch''' may refer to:
* "Switch", a song by Siouxsie & the Banshees from ''[[The Scream (album)|The Scream]]''<br />Markup: <code><nowiki>"Switch", a song by Siouxsie & the Banshees from ''[[The Scream (album)|The Scream]]''</nowiki></code>
+
* "Switch", a song by Siouxsie & the Banshees from ''[[Wikipedia:The Scream (album)|The Scream]]''<br />Markup: <code><nowiki>"Switch", a song by Siouxsie & the Banshees from ''[[The Scream (album)|The Scream]]''</nowiki></code>
 
|}
 
|}
* Piping may be used ''when the link is in the description'' (see {{section link||Items appearing within other articles}}) for linking to a section or [[Help:Section#Section linking|anchor point]] rather than an entire article. For example, on [[E (disambiguation)]], the piped [[ESRB#Ratings|ESRB]] (<code><nowiki>[[ESRB#Ratings|ESRB]]</nowiki></code>) is preferable to simply linking to the entire article [[ESRB]]. Piping is commonly used to link to the track listing section of an album article. The text of the link should not be the title of a different article, and should not surprise the reader. For example:
+
* Piping may be used ''when the link is in the description'' (see {{section link||Items appearing within other articles}}) for linking to a section rather than an entire article. For example, on [[Wikipedia:E (disambiguation)|E (disambiguation)]], the piped [[Wikipedia:ESRB#Ratings|ESRB]] (<code><nowiki>[[ESRB#Ratings|ESRB]]</nowiki></code>) is preferable to simply linking to the entire article [[Wikipedia:ESRB|ESRB]]. Piping is commonly used to link to the track listing section of an album article. The text of the link should not be the title of a different article, and should not surprise the reader. For example:
 
:{| style="border: 1px solid black" width=80%
 
:{| style="border: 1px solid black" width=80%
 
|-
 
|-
 
|
 
|
 
'''Ten''' may refer to:
 
'''Ten''' may refer to:
* (correct) Ten or Tenshinhan, a [[List of Dragon Ball characters#Tenshinhan|character in Dragon Ball media]]<br />Markup: <code><nowiki>Ten or Tenshinhan, a [[List of Dragon Ball characters#Tenshinhan|character in Dragon Ball media]]</nowiki></code>
+
* (correct) Ten or Tenshinhan, a [[Wikipedia:List of Dragon Ball characters#Tenshinhan|character in Dragon Ball media]]<br />Markup: <code><nowiki>Ten or Tenshinhan, a [[List of Dragon Ball characters#Tenshinhan|character in Dragon Ball media]]</nowiki></code>
* (incorrect) Ten or Tenshinhan, a character in [[List of Dragon Ball characters#Tenshinhan|Dragon Ball]] media<br />Markup: <code><nowiki>Ten or Tenshinhan, a character in [[List of Dragon Ball characters#Tenshinhan|Dragon Ball]] media</nowiki></code>
+
* (incorrect) Ten or Tenshinhan, a character in [[Wikipedia:List of Dragon Ball characters#Tenshinhan|Dragon Ball]] media<br />Markup: <code><nowiki>Ten or Tenshinhan, a character in [[List of Dragon Ball characters#Tenshinhan|Dragon Ball]] media</nowiki></code>
 
|}
 
|}
  
=====Section and anchor point linking=====
+
== Specific entry types ==
{{Shortcut|MOS:DABSECTION|WP:DABSECTION|MOS:DABANCHOR|WP:DABANCHOR}}
+
===External links===
 
 
[[Help:Link#Section linking (anchors)|Section and anchor points]] in links should not be visible to the reader (e.g., <code><nowiki>[[Galactic quadrant (Star Trek)#Delta Quadrant]]</nowiki></code>). If an anchor-point link is needed:
 
* For linking the subject, link to a redirect to the anchor point (or leave the subject unlinked and move the link to the description).
 
* For links in the description, link to a redirect or use an anchor-point link with piping to display text similar to the article title.
 
When creating a redirect to a section, add the template {{tlx|R to section}} on the redirect page, and place the {{tlx|anchor}} template at the targeted section.
 
  
=== Specific entry types ===
 
====External links====
 
{{shortcut|MOS:DABEXT}}
 
 
External links do not belong on disambiguation pages; they should not be used.
 
External links do not belong on disambiguation pages; they should not be used.
  
==== Foreign languages ====
+
=== Places ===
{{clear}}
 
{{shortcut|MOS:DABOTHERLANG}}
 
For '''foreign-language terms''', be sure an article exists or could be written for the word or phrase in question. Usually this means that the term has been at least partially adopted into English or is used by specialists.
 
 
 
:{| style="border: 1px solid black" width=80%
 
|-
 
|'''Tambo''' may refer to:
 
* [[Tambo (weapon)]], a very short staff used in martial arts
 
|}
 
 
 
Avoid adding foreign words or phrases that are merely translations of an English term. For example, do {{em|not}} include:
 
*'''Tambo''', a Japanese word (田んぼ) for [[rice paddy]]
 
 
 
Instead, consider [[#Linking to Wiktionary|linking to Wiktionary]].
 
 
 
==== People ====
 
{{Shortcut|MOS:DABPEOPLE}}
 
For '''people''', include their birth and death years (when known), and only enough descriptive information that the reader can distinguish between different people with the same name. Keep in mind the conventions for birth and death dates—see {{section link|Wikipedia:Manual of Style/Dates and numbers|Dates of birth and death}}. Do not include ''a'', ''an'' or ''the'' before the description of the person's occupation or role.
 
 
 
:{| style="border: 1px solid black" width=80%
 
|-
 
|'''[[John Adams]]''' (1735–1826) was the second President of the United States (1797–1801).
 
 
 
'''John Adams''' may also refer to:
 
*[[John Adams (composer)]] (born 1947), American composer, came to prominence with ''Shaker Loops'' in 1978
 
*[[John Adams (physicist)]] (1920–1984), Director General of CERN and particle accelerator designer
 
*[[John Worthington Adams]] (1764–1837), British general in India
 
|}
 
  
==== Places ====
 
{{Shortcut|MOS:DABPLACES}}
 
 
For '''places''', it may only be necessary to write the name of the article.
 
For '''places''', it may only be necessary to write the name of the article.
  
 
:{| style="border: 1px solid black" width=80%
 
:{| style="border: 1px solid black" width=80%
 
|-
 
|-
|'''[[Jacksonville]]''' is the largest city in the U.S. state of Florida.
+
|'''[[Wikipedia:Jacksonville|Jacksonville]]''' is the largest city in the U.S. state of Florida.
  
 
'''Jacksonville''' may also refer to:
 
'''Jacksonville''' may also refer to:
* [[Jacksonville, Alabama]]
+
* [[Wikipedia:Jacksonville, Alabama|Jacksonville, Alabama]]
* [[Jacksonville, Arkansas]]
+
* [[Wikipedia:Jacksonville, Arkansas|Jacksonville, Arkansas]]
 
|}
 
|}
  
It may be appropriate to add the country after the link. Leave the country unlinked.
+
===Red links===
 
 
:{| style="border: 1px solid black" width=80%
 
|-
 
|'''Kimberley''' may refer to:
 
* [[Kimberley, British Columbia]], Canada
 
* [[Kimberley, Nottinghamshire]], United Kingdom
 
|}
 
  
====Red links====
+
A link to a non-existent article (a "[[Wikipedia:Red link|red link]]") should only be included on a disambiguation page when a linked article (not just other disambiguation pages) also includes that red link. Do not create red links to articles that are unlikely ever to be written. To find out if any article uses the red link, click on it, and then click "[[Wikipedia:Help:What links here|What links here]]" on the toolbox on the left side of the page.
{{shortcut|MOS:DABRL|MOS:DABRED}}
 
A link to a non-existent article (a "[[Wikipedia:Red link|red link]]") should only be included on a disambiguation page when a linked article (not just other disambiguation pages) also includes that red link. Do not create red links to articles that are unlikely ever to be written, or are likely to be removed as insufficiently notable topics. To find out if any article uses the red link, click on it, and then click "[[Help:What links here|What links here]]" on the toolbox on the left side of the page.
 
  
 
If the only pages that use the red link are disambiguation pages, do one of the following:
 
If the only pages that use the red link are disambiguation pages, do one of the following:
* Unlink the entry word but still keep a blue link in the description. Red links should not be the {{em|only}} link in a given entry; link also to an existing article, so that a reader (as opposed to a contributing editor) will have somewhere to navigate to for additional information. The linked article should contain some meaningful information about the term.
+
* Unlink the entry word but still keep a blue link in the description. Red links should not be the ''only'' link in a given entry; link also to an existing article, so that a reader (as opposed to a contributing editor) will have somewhere to navigate to for additional information. The linked article should contain some meaningful information about the term.
 
* Start a new article for the red link, using the description on the disambiguation page.
 
* Start a new article for the red link, using the description on the disambiguation page.
 
* Make a redirect to a page where the item is described (see {{section link||Piping and redirects}} above).
 
* Make a redirect to a page where the item is described (see {{section link||Piping and redirects}} above).
  
In the following (made-up) examples, if the entry with the architectural motif is judged to be appropriate for a future article, and assuming that the fictitious "flibbygibby" is mentioned in its respectively linked article, it is considered a valid entry. If "flibbygibby" is not mentioned in the noodle article, or there is no linked article at all, as in the toy example, it is not a valid entry; therefore, only the entry for the architectural motif can include a red link.
+
=== Synonyms ===
 
 
:{| style="border: 1px solid black" width=80%
 
|-
 
|'''Flibbygibby''' may refer to:
 
* [[Flibbygibby (architecture)]], a flamingo motif used on [[cornice]]s {{tick}}
 
* Flibbygibby, a type of [[noodle]] {{cross}}
 
* [[Flibbygibby]], a type of toy {{cross}}
 
|}
 
  
==== Synonyms ====
 
{{shortcut|MOS:DABSYN}}
 
 
If the link is to a '''synonym''', simply use it as it is named:
 
If the link is to a '''synonym''', simply use it as it is named:
  
Line 333: Line 258:
 
|-
 
|-
 
|'''Serving spoon''' may also refer to:
 
|'''Serving spoon''' may also refer to:
* [[Tablespoon]]
+
* [[Wikipedia:Tablespoon|Tablespoon]]
 
|}
 
|}
  
==== Items appearing within other articles ====
+
=== Items appearing within other articles ===
{{shortcut|MOS:DABMENTION}}
+
 
 
If a topic does not have an article of its own, but ''is mentioned'' within another article, then a link to that article should be included. In this case, the link does not start the line, but it should still be the only blue wikilink. For example:
 
If a topic does not have an article of its own, but ''is mentioned'' within another article, then a link to that article should be included. In this case, the link does not start the line, but it should still be the only blue wikilink. For example:
  
Line 343: Line 268:
 
|-
 
|-
 
|'''Maggie Anderson''' may also refer to:
 
|'''Maggie Anderson''' may also refer to:
*Maggie Anderson, actress in the 2007 film [[Corpus Callosum (2007 film)|''Corpus Callosum'']]
+
*Maggie Anderson, actress in the 2007 film [[Wikipedia:Corpus Callosum (2007 film)|Corpus Callosum (2007 film)|''Corpus Callosum'']]
*Maggie Anderson, a character in the musical play ''[[Brigadoon]]''
+
*Maggie Anderson, a character in the musical play ''[[Wikipedia:Brigadoon|Brigadoon]]''
 
|}
 
|}
  
It is often useful to link to the relevant {{em|section}} of the target page using [[Help:Anchors|anchors]] and conceal that by making it a piped link. For examples, see "Where piping may be appropriate" under {{section link||Exceptions}}, above.
+
It is often useful to link to the relevant ''section'' of the target page. For examples, see [[#Where piping may be appropriate|&sect; "Where piping may be appropriate"]].
  
 
If the topic is not mentioned on the other article, that article should not be linked to in the disambiguation page, since linking to it would not help readers find information about the sought topic.
 
If the topic is not mentioned on the other article, that article should not be linked to in the disambiguation page, since linking to it would not help readers find information about the sought topic.
  
====Acronyms, initialisms, and abbreviations====
+
===Acronyms, initialisms, and abbreviations===
{{shortcut|MOS:DABACRO|MOS:DABINITIALS|MOS:DABABRV}}
 
  
 
Many pages serve primarily to disambiguate short letter combinations that can represent various acronyms and initialisms. When considering articles to include in the list, it is important that each individual entry is referred to its respective abbreviation within its article. For example:
 
Many pages serve primarily to disambiguate short letter combinations that can represent various acronyms and initialisms. When considering articles to include in the list, it is important that each individual entry is referred to its respective abbreviation within its article. For example:
Line 359: Line 283:
 
|-
 
|-
 
|'''BSA''' may refer to:
 
|'''BSA''' may refer to:
*(correct) [[Boy Scouts of America]]
+
*(correct) [[Wikipedia:Boy Scouts of America|Boy Scouts of America]]
*(incorrect) ''[[The British Soap Awards]]''
+
*(incorrect) ''[[Wikipedia:The British Soap Awards|The British Soap Awards]]''
 
|}
 
|}
  
The second entry is incorrect because the article that it refers to, the ''British Soap Awards'', does not mention that it is abbreviated "BSA", and therefore is unlikely to be searched for by that letter combination. The Boy Scouts of America page, however, notes that the organization ''is'' abbreviated "BSA", and would thus be a likely candidate for someone searching that initialism. See also [[WP:DABABBREV]].
+
The second entry is incorrect because the article that it refers to, the ''British Soap Awards'', does not mention that it is abbreviated "BSA", and therefore is unlikely to be searched for by that letter combination. The Boy Scouts of America page, however, notes that the organization ''is'' abbreviated "BSA", and would thus be a likely candidate for someone searching that initialism. See also [[Wikipedia:WP:DABABBREV|Wikipedia:Disambiguation#Abbreviations, initials, and acronyms]].
  
==Organization==
+
=Organization=
 +
 
 +
==Ordering==
  
===Ordering===
 
{{anchor|Order of entries|reason=Old heading name, probably linked to from somewhere.}}
 
{{shortcut|MOS:DABORDER}}
 
 
The following guidelines describe the appropriate order of entries on disambiguation pages:
 
The following guidelines describe the appropriate order of entries on disambiguation pages:
# The [[#Linking to a primary topic|primary topic]], if there is one, should be placed at the top. In cases where a small number of main topics are significantly more likely to be the reader's target, several of the most common meanings may be placed at the top, with other meanings below. See [[Mojave (disambiguation)|Mojave]] or [[Mercury (disambiguation)|Mercury]] for examples of this.
+
# The [[#Linking to a primary topic|primary topic]], if there is one, should be placed at the top. In cases where a small number of main topics are significantly more likely to be the reader's target, several of the most common meanings may be placed at the top, with other meanings below. See [[Wikipedia:Mojave (disambiguation)|Mojave]] or [[Wikipedia:Mercury (disambiguation)|Mercury]] for examples of this.
 
#  Long disambiguation pages should be grouped into subject sections, and even subsections as necessary, as [[#Organizing long lists by subject sections|described below]]. These sections (and any subsections) should typically be in alphabetical order, e.g.: Arts and entertainment; Business; Government and politics; Places; Science and technology.
 
#  Long disambiguation pages should be grouped into subject sections, and even subsections as necessary, as [[#Organizing long lists by subject sections|described below]]. These sections (and any subsections) should typically be in alphabetical order, e.g.: Arts and entertainment; Business; Government and politics; Places; Science and technology.
{{em|Within}} each section, entries should be ordered to best assist the reader in finding their intended article. Entries are typically ordered first by similarity to the ambiguous title, then alphabetically or chronologically as appropriate. A recommended order is:
+
''Within'' each section, entries should be ordered to best assist the reader in finding their intended article. Entries are typically ordered first by similarity to the ambiguous title, then alphabetically or chronologically as appropriate. A recommended order is:
## Articles with a clarifier in parentheses: e.g., [[Moss (band)]]
+
## Articles with a clarifier in parentheses: e.g., [[Wikipedia:Moss (band)|Moss (band)]]
## Articles with a clarifier following a comma: e.g., [[Moss, Monterey County, California]]
+
## Articles with a clarifier following a comma: e.g., [[Wikipedia:Moss, Monterey County, California|Moss, Monterey County, California]]
## Articles with the item as part of the name: e.g., [[Moss Bros]] (Only include articles whose subject might {{em|reasonably}} be called by the ambiguous title.)
+
## Articles with the item as part of the name: e.g., [[Wikipedia:Moss Bros|Moss Bros]] (Only include articles whose subject might ''reasonably'' be called by the ambiguous title.)
## Synonyms: e.g., [[Tincture]] on [[Spirit (disambiguation)]]{{shortcut|MOS:DABSEEALSO}}
+
## Synonyms: e.g., [[Wikipedia:Tincture|Tincture]] on [[Wikipedia:Spirit (disambiguation)|Spirit (disambiguation)]]
 
<ol start="4"><li>Some entries may belong in a "See also" section at the bottom of the page:
 
<ol start="4"><li>Some entries may belong in a "See also" section at the bottom of the page:
# Terms which can be confused with {{var|Title}}, for example [[New Market]] and [[Newmarket]]
+
# Terms which can be confused with ''Title'', for example [[Wikipedia:New Market|New Market]] and [[Wikipedia:Newmarket|Newmarket]]
# Likely misspellings of {{var|Title}}, for example [[Belmont]], [[Belmonte]] and [[Bellmont]]
+
# Likely misspellings of ''Title'', for example [[Wikipedia:Belmont|Belmont]], [[Wikipedia:Belmonte|Belmonte]] and [[Wikipedia:Bellmont|Bellmont]]
# Different forms of {{var|Title}}, for example [[Splitting]], [[Split]], and [[Splitter]]
+
# Different forms of ''Title'', for example [[Wikipedia:Splitting|Splitting]], [[Wikipedia:Split|Split]], and [[Wikipedia:Splitter|Splitter]]
# Links to indexes of article titles beginning with {{var|Title}} (using {{tlx|look from|{{var|Title}}}}) or article titles containing {{var|Title}} (using {{tlx|in title|{{var|Title}}}})
+
# Broader-subject articles that treat the topic in a section: e.g., [[Wikipedia:Brewing|Brewing]] as part of a '''Hops''' dab page  
# Broader-subject articles that treat the topic in a section: e.g., [[Brewing]] as part of a '''Hops''' dab page  
+
# Articles with the item as part of the name, but that are unlikely to be called by the ambiguous title: e.g., [[Wikipedia:Spanish moss|Spanish moss]] as part of a '''Moss''' dab page.</li></ol>
# Articles with the item as part of the name, but that are unlikely to be called by the ambiguous title: e.g., [[Spanish moss]] as part of a '''Moss''' dab page.</li></ol>
+
:The "See also" should always be separated from the other entries with a [[Wikipedia:Help:Section|section header]]. Links to other disambiguation pages should use the "(disambiguation)" link per [[Wikipedia:WP:INTDABLINK|Wikipedia:Links to disambiguation pages]].
:The "See also" should always be separated from the other entries with a [[Help:Section|section header]]. Links to other disambiguation pages should use the "(disambiguation)" link per [[WP:INTDABLINK]].
 
  
 
In the "See also" section of a disambiguation page, an intentional link to another disambiguation page that does not contain "(disambiguation)" in the title should be written as '''<nowiki>[[Foo (disambiguation)]]</nowiki>'''.
 
In the "See also" section of a disambiguation page, an intentional link to another disambiguation page that does not contain "(disambiguation)" in the title should be written as '''<nowiki>[[Foo (disambiguation)]]</nowiki>'''.
Line 391: Line 313:
 
When appropriate, place easily confused terms in a hatnote.
 
When appropriate, place easily confused terms in a hatnote.
  
====Example ordering====
+
===Example ordering===
 
:{| style="border: 1px solid black" width=80%
 
:{| style="border: 1px solid black" width=80%
 
|-
 
|-
<!-- This is just a sample to demonstrate "Order of entries" pls don't add the actual DAB here -->
+
|   
'''[[Moss]]''' is a small, soft, non-vascular plant that lacks both flowers and seeds.
+
'''[[Wikipedia:Moss|Moss]]''' is a small, soft, non-vascular plant that lacks both flowers and seeds.
  
 
'''Moss''' may also refer to:
 
'''Moss''' may also refer to:
* [[Moss (band)]], a UK extreme doom metal band
+
* [[Wikipedia:Moss (band)|Moss (band)]], a UK extreme doom metal band
* [[Moss (given name)]]
+
* [[Wikipedia:Moss (given name)|Moss (given name)]]
* [[Moss, Monterey County, California]]
+
* [[Wikipedia:Moss, Monterey County, California|Moss, Monterey County, California]]
* [[Moss FK]], a Norwegian football club
+
* [[Wikipedia:Moss FK|Moss FK]], a Norwegian football club
  
 
<big><big>See also</big></big>
 
<big><big>See also</big></big>
 
----
 
----
* [[Spanish moss]], a flowering bromeliad plant that grows hanging from tree branches
+
* [[Wikipedia:Spanish moss|Spanish moss]], a flowering bromeliad plant that grows hanging from tree branches
* [[Bog]]
+
* [[Wikipedia:Bog|Bog]]
* [[MOSS (disambiguation)]]
+
* [[Wikipedia:MOSS (disambiguation)|MOSS (disambiguation)]]
 
|}
 
|}
  
===Grouping by subject area===
+
==Grouping by subject area==
{{shortcut|MOS:DABGROUPING}}
 
{{anchor|Organizing long lists by subject sections|reason=Old section name, probably linked to from somewhere.}}
 
A large number of topics can make it difficult for a reader to find a particular topic. On longer disambiguation pages, separate entries by subject [[WP:SECTION|sections]]. Subject areas should be chosen carefully {{em|to simplify navigation}}; see [[Wikipedia:Organizing disambiguation pages by subject area|Organizing disambiguation pages by subject area]] for detailed guidance. Use subject areas that are well-defined, and that group the entries into similarly sized sections. Very small sections may impede navigation, and should usually be avoided. Section headings should be as simple as possible; '''Sports''' is preferred to '''Sports people''' or '''Sports figures''', since the nature of the category (people, in this case) should be obvious.
 
  
Entries which do not fit neatly into any section should be placed in an "Other uses" section or subsection, at the bottom of the page or section (but above any [[MOS:DABSEEALSO|"See also" section]]). The "Other uses" section should be relatively short; if it becomes excessively long, the page may need to be reorganized. Uncategorized entries should {{em|never}} be left at the top of the page, with the exception of one or two primary topics as stated [[MOS:DABORDER|above]].
+
A large number of topics can make it difficult for a reader to find a particular topic. On longer disambiguation pages, separate entries by subject [[Wikipedia:WP:SECTION|sections]]. Subject areas should be chosen carefully ''to simplify navigation''; see [[Wikipedia:Wikipedia:Organizing disambiguation pages by subject area|Wikipedia:Organizing disambiguation pages by subject area]] for detailed guidance. Use subject areas that are well-defined, and that group the entries into similarly sized sections. Very small sections may impede navigation, and should usually be avoided. Section headings should be as simple as possible; '''Sports''' is preferred to '''Sports people''' or '''Sports figures''', since the nature of the category (people, in this case) should be obvious.
 
 
Keep in mind that a particular division scheme may not work equally well on all disambiguation pages. An example:
 
 
 
:{| style="border: 1px solid black" width=80%
 
|-
 
|
 
'''Thingamajig''' may refer to:
 
  
{{fake heading|sub=2|Science}}
+
Entries which do not fit neatly into any section should be placed in an "Other uses" section or subsection, at the bottom of the page or section (but above any [[#Ordering|"See also" section]]). The "Other uses" section should be relatively short; if it becomes excessively long, the page may need to be reorganized. Uncategorized entries should ''never'' be left at the top of the page, with the exception of one or two primary topics as stated [[#Order of entries|above]].
* [[Thingamajig|Thingamajig (biology)]], an invasive plant used as ground cover
 
* [[Thingamajig|Thingamajig (chemistry)]], an isotope of chlorine
 
* [[Thingamajig|Thingamajig (physics)]], a kind of pulsar
 
  
{{fake heading|sub=2|World music}}
+
Keep in mind that a particular division scheme may not work equally well on all disambiguation pages.
* [[Thingamajig|Thingamajig (Peru)]], a wind instrument similar to an aulos
 
* [[Thingamajig|Thingamajig (Qatar)]], a seven-stringed musical instrument
 
* [[Thingamajig|Thingamajig (UK)]], a wind instrument, similar to, but longer than the Peruvian one
 
|}
 
  
Use sections rather than bold text (see [[WP:PSEUDOHEAD]]). Using more than one level may be necessary, as on [[Aurora (disambiguation)]]. Always use <nowiki>==Level two==</nowiki> as the highest-level header. Section headings should not include links. See {{section link|Wikipedia:Writing better articles|Headings}} for more.
+
Use sections rather than bold text (see {{section link|UniWiki:Manual of Style/Accessibility|Headings}}). Using more than one level may be necessary, as on [[Wikipedia:Aurora (disambiguation)|Aurora (disambiguation)]]. Always use <nowiki>==Level two==</nowiki> as the highest-level header. Section headings should not include links. See [[Wikipedia:Wikipedia:Writing better articles#Headings|Wikipedia:Writing better articles &sect; Headings]] for more.
  
On longer lists, {{tlx|TOC right}} may be used to move the table of contents to the right hand side of the page. This reduces the amount of white space and may improve the readability of the page. (For more information, see {{section link|Help:Section|Floating the TOC}}.) If used, {{tlx|TOC right}} should be placed after the lead section of the wiki markup and immediately before the first section heading. Users of screen readers do not expect any text between the TOC and the first heading, and having no text above the TOC is confusing. (For more information, see {{section link|Wikipedia:Accessibility|Article structure}}.)
+
On longer lists, {{tl|tocright}} may be used to move the table of contents to the right hand side of the page. This reduces the amount of white space and may improve the readability of the page. (For more information, see [[Wikipedia:Help:Section#Floating the TOC|Wikipedia:Floating the TOC]].) If used, {{tl|tocright}} should be placed after the lead section of the wiki markup and immediately before the first section heading. Users of screen readers do not expect any text between the TOC and the first heading, and having no text above the TOC is confusing. (For more information, see {{section link|UniWiki:Manual of Style/Accessibility|Article structure}}.)
  
== Images and templates==
+
=Images and templates=
{{shortcut|MOS:DABICON}}
 
Including images and transcluding templates are discouraged unless they aid in selecting between articles on the particular search term in question. Examples of this are the images at [[Congo (disambiguation)]] and [[Mississippi Delta (disambiguation)]].
 
  
Icons, including flag icons, should not be used on disambiguation pages. Only if flag topics are being disambiguated and images are needed to do so, then flag icons or flag images might be added. See also: [[Wikipedia:Manual of Style/Icons]].
+
Including images and transcluding templates are discouraged unless they aid in selecting between articles on the particular search term in question. Examples of this are the images at [[Wikipedia:Congo (disambiguation)|Congo (disambiguation)]] and [[Wikipedia:Mississippi Delta (disambiguation)|Mississippi Delta (disambiguation)]].
  
== The disambig notice and categorization==
+
Icons, including flag icons, should not be used on disambiguation pages. Only if flag topics are being disambiguated and images are needed to do so, then flag icons or flag images might be added. See also: [[UniWiki:Manual of Style/Icons]].
{{shortcut|WP:DCAT}}
 
{{see also|Wikipedia:Disambiguation#Categories}}
 
After all of the disambiguation content (including the See also section, if present), but before any categories (see below) or [[Help:Interlanguage links|interlanguage links]], a template should be placed identifying the page as a disambiguation page. This generates a message to the reader explaining the purpose of the page, and also places the page in the appropriate [[Wikipedia:Categorization|category or categories]].
 
  
The usual template to use is {{tlx|disambig}}, which produces a general disambiguation notice, and places the page in [[:Category:Disambiguation pages]]. Parameters can be added to place the page {{em|additionally}} into other more specific disambiguation categories. For example, if a page includes multiple places and multiple people with the same surname (and possibly other items), use {{tlx|disambig|geo|surname}}. A full list of available parameters and their corresponding categories can be found in the {{tlx|disambig}} template documentation.
+
=The disambig notice and categorization=
 +
:''See also: [[Wikipedia:Wikipedia:Disambiguation#Categories|Wikipedia:Disambiguation#Categories]]''
  
If a disambiguation page consists {{em|exclusively}} of items in one of the more specific classes, then a specific template should be used instead of {{tlx|disambig}}. For example, use {{tlx|geodis}} for locations, {{tlx|hndis}} for human names and so on. A full list can be found in the {{tlx|disambig}} template documentation.  
+
After all of the disambiguation content (including the See also section, if present), but before any categories (see below), a template should be placed identifying the page as a disambiguation page. This generates a message to the reader explaining the purpose of the page, and also places the page in the appropriate [[Wikipedia:Wikipedia:Categorization|category or categories]].
  
If a disambiguation page needs cleaning up to bring it into conformance with this style manual, use {{tlx|disambig-cleanup}}. This replaces {{em|both}} {{tlx|disambig}} and {{tlx|cleanup-date}}.
+
The usual template to use is {{tl|disambig}}, which produces a general disambiguation notice, and places the page in [[:Category:Disambiguation]]. Parameters can be added to place the page ''additionally'' into other more specific disambiguation categories.
  
Do not use <code><nowiki>{{subst:disambig}}</nowiki></code> or <code><nowiki>{{subst:disambig-cleanup}}</nowiki></code>, as the contents of this notice may change in the future (see [[Wikipedia:Transclusion costs and benefits]]). Also, the Wikipedia software relies on links to the templates to determine which pages are disambiguation pages <!-- (see [[MediaWiki:Disambiguationspage]]) page no longer exists; a version of it has been archived at [[Wikipedia:Historical archive/MediaWiki:Disambiguationspage]] but is not maintained. -->, and subst'ing breaks this feature.
+
Do not use <code><nowiki>{{subst:disambig}}</nowiki></code> or <code><nowiki>{{subst:disambig-cleanup}}</nowiki></code>, as the contents of this notice may change in the future (see [[Wikipedia:Wikipedia:Transclusion costs and benefits|Wikipedia:Transclusion costs and benefits]]). Also, the MediaWiki software relies on links to the templates to determine which pages are disambiguation pages, and subst'ing breaks this feature.
  
Most disambiguation pages do not need to be placed into any categories other than those generated by the template. If such cases do arise (for example, specific categories of personal names that do not have corresponding template parameters), then the additional categories should be placed after the template.
+
= Exceptions =
 +
== Set index articles ==
  
If new topical categories of disambiguation pages seem to be needed, please bring this up for discussion at [[Wikipedia talk:Disambiguation]].
+
[[Wikipedia:Wikipedia:Set index articles|Set index articles]] are [[UniWiki:Manual of Style/Lists|list articles]] about a set of items ''of a specific type'' that have similar or identical names. '''Set index articles are not disambiguation pages''' and do not have to follow the style outlined on this page. Note that the set index article exception was designed to be narrow: for pages that contain links to articles about different topics, please follow this style guide for disambiguation pages. An example of a set index article is a list of ships with the same name, such as [[Wikipedia:HMS Albatross|HMS ''Albatross'']].
  
== Exceptions ==
+
== Disambiguation pages with only two entries ==
=== Set index articles ===
+
:''See also: [[Wikipedia:Wikipedia:Disambiguation#Disambiguation page or hatnotes?|Wikipedia:Disambiguation page or hatnotes?]]''
{{Shortcut|MOS:DABNOTINDEX}}
 
[[Wikipedia:Set index articles|Set index articles]] are [[Wikipedia:Manual of Style/Lists|list articles]] about a set of items {{em|of a specific type}} that have similar or identical names. '''Set index articles are not disambiguation pages''' and do not have to follow the style outlined on this page. Note that the set index article exception was designed to be narrow: for pages that contain links to articles about different topics, please follow this style guide for disambiguation pages. An example of a set index article is a list of ships with the same name, such as [[HMS Albatross|HMS ''Albatross'']]. For more information about such ship lists, see {{section link|Wikipedia:WikiProject Ships/Guidelines|Index pages}}.
 
  
=== Disambiguation pages with only two entries ===
+
A disambiguation page with only two meanings is not necessary if one of them is the [[Wikipedia:WP:PRIMARYTOPIC|primary topic]] for that term. The recommended practice in these situations is to place a [[Wikipedia:Wikipedia:Hatnote|hatnote]] on the primary topic article to link directly to the secondary topic.
{{further information|Wikipedia:Disambiguation#Disambiguation page or hatnotes?}}
 
A disambiguation page with only two meanings is not necessary if one of them is the [[WP:PRIMARYTOPIC|primary topic]] for that term. The recommended practice in these situations is to place a [[Wikipedia:Hatnote|hatnote]] on the primary topic article to link directly to the secondary topic. The {{tlx|for}} and {{tlx|redirect}} templates are useful. A two-entry disambiguation page with a primary topic can be tagged with {{tlx|only-two-dabs}}.
 
  
 
If neither of the two meanings is primary, then a normal disambiguation page is still used at the base name.
 
If neither of the two meanings is primary, then a normal disambiguation page is still used at the base name.
  
== When to break Wikipedia rules ==
+
= When to break UniWiki rules =
{{see also|Wikipedia:Ignore all rules}}
+
:''See also: [[Wikipedia:Wikipedia:Ignore all rules|Wikipedia:Ignore all rules]]''
 +
 
 
Application of these guidelines will generally produce useful disambiguation pages which are consistent with each other and therefore easily usable by most readers. Usefulness to the reader is their principal goal. However, for every style recommendation above, there may be pages in which a good reason exists to use another way; so ignore these guidelines if doing so will be more helpful to readers than following them.
 
Application of these guidelines will generally produce useful disambiguation pages which are consistent with each other and therefore easily usable by most readers. Usefulness to the reader is their principal goal. However, for every style recommendation above, there may be pages in which a good reason exists to use another way; so ignore these guidelines if doing so will be more helpful to readers than following them.
  
== See also ==
+
= See also =
* [[Wikipedia:Disambiguation dos and don'ts|Disambiguation dos and don'ts]] (information page summarizing key points of this guideline)
+
* [[Wikipedia:Wikipedia:Disambiguation dos and don'ts|Disambiguation dos and don'ts]] (information page summarizing key points of this guideline)
* [[Wikipedia:Disambiguation pages with links|Disambiguation pages with links]]
 
* [[:Category:Disambiguation pages in need of cleanup]]
 
* [[Wikipedia:Database reports#Disambiguations|Database reports]]
 
 
 
[[Category:UniWiki Manual of Style]]
 

Latest revision as of 19:06, 16 November 2021

This page is a part of the UniWiki's Manual of Style. It is a general guideline intended to harmonize article style across the UniWiki, though it is best treated with common sense, and exceptions may apply. Any substantive edit to this page should be approved by the Wiki Manager. When in doubt, discuss first on the talk page.

Disambiguation pages ("dab pages") are designed to help a reader find UniWiki articles on different topics that could be referenced by the same search term, as described in the Disambiguation guideline. Disambiguation pages are not articles; they are aids in searching.

This style guideline is intended to make the search more efficient, by giving disambiguation pages a consistent look and by avoiding distracting information. In brief, the pages should contain only disambiguation content, whether or not the page title contains the parenthetical (disambiguation). (This guideline does not apply to articles that are primary topics, even if the articles are prefaced by a "See also" hatnote or the like at the top of the page.)

Page naming

In general, the title of a disambiguation page is the ambiguous term itself, provided there is no primary topic for that term. If there is already a primary topic, then "(disambiguation)" is added to the title of the disambiguation page, as in Jupiter (disambiguation). For more on how to title a disambiguation page, see Wikipedia:Naming the disambiguation page.

At the top of the page

The first line of a disambiguation page should be the introductory line (see below). If there is a link to the primary topic (see below), that line should appear before the introductory line. Both of these should begin its own line.

Linking to a primary topic

When a page has "(disambiguation)" in its title – i.e., it is the disambiguation page for a term for which a primary topic has been identified – users are most likely to arrive there by clicking on a top link from the primary topic article.

The primary topic is the one reached by using the disambiguation page title without the (disambiguation) qualifier. Capitalization differences matter, so there will only be one primary topic for a title.

Since it is unlikely that this primary topic is what readers are looking for if they have reached the disambiguation page, it should not be mixed in with the other links. It is recommended that the link back to the primary topic appear at the top, in a brief explanatory sentence. For instance:

A school is an institution for learning.

School may also refer to:

  • School of thought, a number of individuals with shared styles, approaches or aims
  • School (fish), a group of fish swimming in the same direction in a coordinated manner
  • . . .

When the ambiguous term has a primary topic but that article has a different title (so that the term is the title of a redirect), the primary topic line normally uses the redirect to link to that article:

A cosmonaut or astronaut is a person trained by a human spaceflight program to command, pilot, or serve as a crew member of a spacecraft.

Similarly for an acronym, initialism or alphabetism:

CIA is the Central Intelligence Agency, a civilian agency of the United States government.

In some cases it may be clearer to link directly to the redirect target:

Wolfgang Amadeus Mozart (1756–1791) was a famous composer during the Classical period.

instead of the more awkward

Mozart was Wolfgang Amadeus Mozart (1756–1791), a famous composer during the Classical period.

Introductory line

See also: Wikipedia:Template messages#In introductory lines

The term being disambiguated should be in bold (not italics). It should begin a sentence fragment ending with a colon, introducing a bulleted list:

Interval may refer to:


John Smith may refer to:

or

John Smith is the name of:


ABC may refer to:

or

ABC may stand for:

Where several variants of a term are being disambiguated together, significant variants may be included in the lead sentence. For example:

Bang or bangs may refer to:

or

Bang(s) may refer to:

Arc or ARC may refer to:

Angus McKay, MacKay or Mackay may refer to:

However, it is not necessary to mention minor variations of capitalization, punctuation or diacritics. For example, AU may refer to: is preferable to "AU, au, Au or A-U may refer to"; and Saiyuki may refer to: is preferable to "Saiyuki, Saiyūki or Saiyûki may refer to".

Individual entries

After the introductory line comes a list of individual entries – lines which direct the readers to Wikipedia articles on the various topics which might be referenced by the term being disambiguated. Keep in mind that the primary purpose of the disambiguation page is to help people find the specific article they want quickly and easily.

Example:

Interval may refer to:

Apply the following rules when constructing entries:

  • Preface each entry with a bullet (an asterisk in wiki markup).
  • Start each entry with a capital letter.
  • Insert a comma after an entry when a description is included.
  • Use sentence fragments, with no closing punctuation unless it is part of the description (e.g., a description that ends in "etc." would end with the period)
  • Include exactly one navigable (blue) link to efficiently guide readers to the most relevant article for that use of the ambiguous term. Do not wikilink any other words in the line. For example:

but not:

and avoid redundancies like:

  • Do not emphasize the link with bolding or italics, although titles (such as for books and movies) may need to be italicized to conform with the style guidance on titles. If the article's title contains both a title and a clarifier, quote or italicize only the part requiring such treatment, as opposed to the entire link, e.g.: Dark Star (film) (see § Piping and redirects). This can be accomplished by piping the link.
  • Keep the description associated with a link to a minimum, just sufficient to allow the reader to find the correct link. In many cases, the title of the article alone will be sufficient and no additional description is necessary.

In most cases the title of the target article will be an expansion or variation of the term being disambiguated (as in the example above). If this is the case:

  • The link should come at the start of the entry.
  • The article title should appear exactly as it is on the target page; the link should not be piped except to apply formatting (see § Where piping may be appropriate).

In some cases, however, the target article title is not an expansion or variation of the term being disambiguated. For these cases see § Red links and § Items appearing within other articles below.

Note also the following points when constructing lists of entries:

  • An entry with no links at all is useless for further navigation. (See § Red links for cases in which no article yet exists.)
  • A disambiguation page should not be made up completely of red links or have only one blue link on the entire page, because the basic purpose of disambiguation is to refer users to other Wikipedia pages.
  • Never include external links, either as entries or in descriptions. Disambiguation pages disambiguate Wikipedia articles, not the World-Wide Web. To note URLs that might be helpful in the future, include them on the talk page.
  • References should not appear on disambiguation pages. Dab pages are not articles; instead, incorporate the references into the target articles.

Examples of individual entries that should not be created

See also: Wikipedia:Disambiguation#What not to include

Do not include entries for topics that are not ambiguous (according to the linked article) with the title. Use list articles for lists of related topics if needed.

On a page called Title, do not create entries merely because Title is part of the name (see Wikipedia:Disambiguation § Partial title matches).

Common examples:

  • Title City
  • Title Hospital
  • Title University

The above does not apply if the subject is commonly referred to simply by Title. For instance, Oxford (disambiguation) should link to University of Oxford and Catalina might include Santa Catalina Island, California. If there is disagreement about whether this exception applies, it is often best to assume that it does.

You may want to create entries on the same page for:

  • TITLE and Title
  • Title town and Title township
    • An example is Willow Valley, which lists a town of that name as well as "Willow Valley Township" in another state.

Misspellings

Common misspellings should be listed only if there is a genuine risk of confusion or misspelling. These cross-links should be placed in a separate section entitled "Common misspellings" or "See also". For example, in a page called Kington (disambiguation), a link to Kingston (disambiguation) would appropriately be included in the "See also" section.

Piping and redirects

Piping and redirects are two different mechanisms which allow the displayed text of a link to differ from the title of the page that the link points to.

  • Piping means concealing the title of a linked article by replacing it with other text. For example, instead of showing the full title Moment (physics), it may be presented as [[Moment (physics)|moment]], resulting in the link moment.
  • A redirect is a page used to "jump" readers from one page title to an article with a different title. For example, a redirect at the title 9/11 sends users who navigate there to the article September 11 attacks.

Piping and redirects should not generally be used on disambiguation pages, except as described below.

Subject to certain exceptions as listed below, piping or redirects should not be used in disambiguation pages. This is to make it clear to the reader which topic is the subject of an article title. For example, on the disambiguation page Moment, in the entry Moment (physics), " (physics)" should be visible so that the reader sees which "moment" topic the entry is about, among others sharing the same base title. In many cases, what would be hidden by a pipe is exactly what the user would need in order to find their intended article. However, raw section and anchor points should not be displayed; see § Section and anchor point linking for those cases.

Though piping and redirects should generally not be used in disambiguation pages, there are certain cases in which they may be useful to the reader:

Where redirecting may be appropriate

  • A redirect should be used to link to a specific section of an article if the title of that section is more or less synonymous with the disambiguated topic. This indicates a higher possibility that the topic may eventually have its own article. For example:
Delta may refer to:
  • (correct) Delta Quadrant, in the Star Trek universe
    Markup: [[Delta Quadrant]], in the ''Star Trek'' universe
  • (incorrect) Delta Quadrant, in the Star Trek universe
    Markup: [[Galactic quadrant (Star Trek)#Delta Quadrant|Delta Quadrant]], in the ''Star Trek'' universe
  • (incorrect) Delta Quadrant, in the Galactic quadrant of the Star Trek universe
    Markup: Delta Quadrant, in the [[Galactic quadrant (Star Trek)#Delta Quadrant|Galactic quadrant of the ''Star Trek'']] universe
The above technique is used when the link is the subject of the line. For description sections, redirects or piped links may be used; follow the normal Wikipedia:Redirect and Wikipedia:Piped link guidelines.
  • Linking to a redirect can also be helpful when both:
  1. the redirect target article contains the disambiguated term; and
  2. the redirect could serve as an alternative name for the target article, meaning an alternative term that is already in the article's lead section.
For example:
James Cary may refer to:
  • (correct) James Carrey or Jim Carrey (born 1962), Canadian actor
    Markup: [[James Carrey]] or Jim Carrey (born 1962), Canadian actor
  • (incorrect) James Carrey or Jim Carrey (born 1962), Canadian actor
    Markup: James Carrey or [[Jim Carrey]] (born 1962), Canadian actor
The above example of a redirect is only appropriate because James Carrey is indicated as a name in the lead section of the Jim Carrey article. If it were not, then the second example could have been used instead.

Where piping may be appropriate

Switch may refer to:

  • "Switch", a song by Siouxsie & the Banshees from The Scream
    Markup: "Switch", a song by Siouxsie & the Banshees from ''[[The Scream (album)|The Scream]]''
  • Piping may be used when the link is in the description (see § Items appearing within other articles) for linking to a section rather than an entire article. For example, on E (disambiguation), the piped ESRB ([[ESRB#Ratings|ESRB]]) is preferable to simply linking to the entire article ESRB. Piping is commonly used to link to the track listing section of an album article. The text of the link should not be the title of a different article, and should not surprise the reader. For example:

Ten may refer to:

  • (correct) Ten or Tenshinhan, a character in Dragon Ball media
    Markup: Ten or Tenshinhan, a [[List of Dragon Ball characters#Tenshinhan|character in Dragon Ball media]]
  • (incorrect) Ten or Tenshinhan, a character in Dragon Ball media
    Markup: Ten or Tenshinhan, a character in [[List of Dragon Ball characters#Tenshinhan|Dragon Ball]] media

Specific entry types

External links

External links do not belong on disambiguation pages; they should not be used.

Places

For places, it may only be necessary to write the name of the article.

Jacksonville is the largest city in the U.S. state of Florida.

Jacksonville may also refer to:

Red links

A link to a non-existent article (a "red link") should only be included on a disambiguation page when a linked article (not just other disambiguation pages) also includes that red link. Do not create red links to articles that are unlikely ever to be written. To find out if any article uses the red link, click on it, and then click "What links here" on the toolbox on the left side of the page.

If the only pages that use the red link are disambiguation pages, do one of the following:

  • Unlink the entry word but still keep a blue link in the description. Red links should not be the only link in a given entry; link also to an existing article, so that a reader (as opposed to a contributing editor) will have somewhere to navigate to for additional information. The linked article should contain some meaningful information about the term.
  • Start a new article for the red link, using the description on the disambiguation page.
  • Make a redirect to a page where the item is described (see § Piping and redirects above).

Synonyms

If the link is to a synonym, simply use it as it is named:

Serving spoon may also refer to:

Items appearing within other articles

If a topic does not have an article of its own, but is mentioned within another article, then a link to that article should be included. In this case, the link does not start the line, but it should still be the only blue wikilink. For example:

Maggie Anderson may also refer to:

It is often useful to link to the relevant section of the target page. For examples, see § "Where piping may be appropriate".

If the topic is not mentioned on the other article, that article should not be linked to in the disambiguation page, since linking to it would not help readers find information about the sought topic.

Acronyms, initialisms, and abbreviations

Many pages serve primarily to disambiguate short letter combinations that can represent various acronyms and initialisms. When considering articles to include in the list, it is important that each individual entry is referred to its respective abbreviation within its article. For example:

BSA may refer to:

The second entry is incorrect because the article that it refers to, the British Soap Awards, does not mention that it is abbreviated "BSA", and therefore is unlikely to be searched for by that letter combination. The Boy Scouts of America page, however, notes that the organization is abbreviated "BSA", and would thus be a likely candidate for someone searching that initialism. See also Wikipedia:Disambiguation#Abbreviations, initials, and acronyms.

Organization

Ordering

The following guidelines describe the appropriate order of entries on disambiguation pages:

  1. The primary topic, if there is one, should be placed at the top. In cases where a small number of main topics are significantly more likely to be the reader's target, several of the most common meanings may be placed at the top, with other meanings below. See Mojave or Mercury for examples of this.
  2. Long disambiguation pages should be grouped into subject sections, and even subsections as necessary, as described below. These sections (and any subsections) should typically be in alphabetical order, e.g.: Arts and entertainment; Business; Government and politics; Places; Science and technology.
  3. Within each section, entries should be ordered to best assist the reader in finding their intended article. Entries are typically ordered first by similarity to the ambiguous title, then alphabetically or chronologically as appropriate. A recommended order is:
    1. Articles with a clarifier in parentheses: e.g., Moss (band)
    2. Articles with a clarifier following a comma: e.g., Moss, Monterey County, California
    3. Articles with the item as part of the name: e.g., Moss Bros (Only include articles whose subject might reasonably be called by the ambiguous title.)
    4. Synonyms: e.g., Tincture on Spirit (disambiguation)
  1. Some entries may belong in a "See also" section at the bottom of the page:
    1. Terms which can be confused with Title, for example New Market and Newmarket
    2. Likely misspellings of Title, for example Belmont, Belmonte and Bellmont
    3. Different forms of Title, for example Splitting, Split, and Splitter
    4. Broader-subject articles that treat the topic in a section: e.g., Brewing as part of a Hops dab page
    5. Articles with the item as part of the name, but that are unlikely to be called by the ambiguous title: e.g., Spanish moss as part of a Moss dab page.
The "See also" should always be separated from the other entries with a section header. Links to other disambiguation pages should use the "(disambiguation)" link per Wikipedia:Links to disambiguation pages.

In the "See also" section of a disambiguation page, an intentional link to another disambiguation page that does not contain "(disambiguation)" in the title should be written as [[Foo (disambiguation)]]. When appropriate, place easily confused terms in a hatnote.

Example ordering

Moss is a small, soft, non-vascular plant that lacks both flowers and seeds.

Moss may also refer to:

See also


Grouping by subject area

A large number of topics can make it difficult for a reader to find a particular topic. On longer disambiguation pages, separate entries by subject sections. Subject areas should be chosen carefully to simplify navigation; see Wikipedia:Organizing disambiguation pages by subject area for detailed guidance. Use subject areas that are well-defined, and that group the entries into similarly sized sections. Very small sections may impede navigation, and should usually be avoided. Section headings should be as simple as possible; Sports is preferred to Sports people or Sports figures, since the nature of the category (people, in this case) should be obvious.

Entries which do not fit neatly into any section should be placed in an "Other uses" section or subsection, at the bottom of the page or section (but above any "See also" section). The "Other uses" section should be relatively short; if it becomes excessively long, the page may need to be reorganized. Uncategorized entries should never be left at the top of the page, with the exception of one or two primary topics as stated above.

Keep in mind that a particular division scheme may not work equally well on all disambiguation pages.

Use sections rather than bold text (see UniWiki:Manual of Style/Accessibility § Headings). Using more than one level may be necessary, as on Aurora (disambiguation). Always use ==Level two== as the highest-level header. Section headings should not include links. See Wikipedia:Writing better articles § Headings for more.

On longer lists, {{tocright}} may be used to move the table of contents to the right hand side of the page. This reduces the amount of white space and may improve the readability of the page. (For more information, see Wikipedia:Floating the TOC.) If used, {{tocright}} should be placed after the lead section of the wiki markup and immediately before the first section heading. Users of screen readers do not expect any text between the TOC and the first heading, and having no text above the TOC is confusing. (For more information, see UniWiki:Manual of Style/Accessibility § Article structure.)

Images and templates

Including images and transcluding templates are discouraged unless they aid in selecting between articles on the particular search term in question. Examples of this are the images at Congo (disambiguation) and Mississippi Delta (disambiguation).

Icons, including flag icons, should not be used on disambiguation pages. Only if flag topics are being disambiguated and images are needed to do so, then flag icons or flag images might be added. See also: UniWiki:Manual of Style/Icons.

The disambig notice and categorization

See also: Wikipedia:Disambiguation#Categories

After all of the disambiguation content (including the See also section, if present), but before any categories (see below), a template should be placed identifying the page as a disambiguation page. This generates a message to the reader explaining the purpose of the page, and also places the page in the appropriate category or categories.

The usual template to use is {{disambig}}, which produces a general disambiguation notice, and places the page in Category:Disambiguation. Parameters can be added to place the page additionally into other more specific disambiguation categories.

Do not use {{subst:disambig}} or {{subst:disambig-cleanup}}, as the contents of this notice may change in the future (see Wikipedia:Transclusion costs and benefits). Also, the MediaWiki software relies on links to the templates to determine which pages are disambiguation pages, and subst'ing breaks this feature.

Exceptions

Set index articles

Set index articles are list articles about a set of items of a specific type that have similar or identical names. Set index articles are not disambiguation pages and do not have to follow the style outlined on this page. Note that the set index article exception was designed to be narrow: for pages that contain links to articles about different topics, please follow this style guide for disambiguation pages. An example of a set index article is a list of ships with the same name, such as HMS Albatross.

Disambiguation pages with only two entries

See also: Wikipedia:Disambiguation page or hatnotes?

A disambiguation page with only two meanings is not necessary if one of them is the primary topic for that term. The recommended practice in these situations is to place a hatnote on the primary topic article to link directly to the secondary topic.

If neither of the two meanings is primary, then a normal disambiguation page is still used at the base name.

When to break UniWiki rules

See also: Wikipedia:Ignore all rules

Application of these guidelines will generally produce useful disambiguation pages which are consistent with each other and therefore easily usable by most readers. Usefulness to the reader is their principal goal. However, for every style recommendation above, there may be pages in which a good reason exists to use another way; so ignore these guidelines if doing so will be more helpful to readers than following them.

See also