Wikipedia:Disambiguation: Difference between revisions
No edit summary |
m →Disambiguation pages: period consistency |
||
(26 intermediate revisions by 18 users not shown) | |||
Line 1: | Line 1: | ||
{{guideline}} |
{{guideline}} |
||
{{Shortcut|[[WP:D]] or [[WP:DAB]]}} |
{{Shortcut|[[WP:D]] or [[WP:DAB]]}} |
||
:''For style guidelines, see [[Wikipedia:Manual of Style (disambiguation pages)|Manual of Style (disambiguation pages)]]'' |
|||
'''Disambiguation''' in Wikipedia and [[Wikimedia]] is the process of resolving ''ambiguity''—meaning the conflicts that occur when articles about two or more different topics have the same "natural" title. In other words, disambiguations are types of turnpikes that lead to different meanings of a related word. |
|||
Wikipedia thrives on the fact that making links is simple and automatic: as you're typing in an edit window, put brackets around [[Mercury]] (like this: <nowiki>[[Mercury]]</nowiki>) and you'll have a link. But were you intending to link to Mercury the [[Mercury (element)|element]], the [[Mercury (planet)|planet]], the [[Mercury (automobile)|automobile brand]], the [[Mercury Records|record label]], the [[Project Mercury|NASA manned-spaceflight project]], or the [[Mercury (mythology)|Roman god]]? |
|||
'''Disambiguation''' in Wikipedia and [[Wikimedia]] is the process of resolving ''ambiguity''—meaning the conflicts that occur when articles about two or more different topics have the same "natural" title. In other words, disambiguations are a type of turnpikes that lead to different meanings of a related word. |
|||
Wikipedia thrives on the fact that making links is simple and automatic: as you're typing in an edit window, put brackets around [[Mercury]] (like this: <nowiki>[[Mercury]]</nowiki>) and you'll have a link. But were you intending to link to Mercury the [[Mercury (element)|element]], the [[Mercury (planet)|planet]], the [[Mercury (automobile)|automobile brand]], the [[Mercury Records|record label]], the [[Project Mercury|NASA manned-spaceflight project]] or the [[Mercury (mythology)|Roman god]]? |
|||
Disambiguation should not be confused with the [[Wikipedia:Merge|merging]] of [[Wikipedia:Duplicate articles|duplicate articles]] (articles with different titles, but regarding the very same topic, for example "Gas Turbine" and "Gas turbine", or "loo" and "restroom"). |
Disambiguation should not be confused with the [[Wikipedia:Merge|merging]] of [[Wikipedia:Duplicate articles|duplicate articles]] (articles with different titles, but regarding the very same topic, for example "Gas Turbine" and "Gas turbine", or "loo" and "restroom"). |
||
__TOC__ |
|||
Two different methods of disambiguating are discussed here: '''disambiguation links''' and '''disambiguation pages'''. In the first case, an article discussing one particular meaning of a term has a link at the top (or, rarely, at the bottom) pointing the user to another page with a similar title. A ''disambiguation page'' contains no article content, only links to other Wikipedia pages. |
|||
==When to disambiguate== |
==When to disambiguate== |
||
Disambiguation |
Disambiguation serves a single purpose: to let the reader choose among different pages that might reside under the same title. |
||
Do not disambiguate, or add a link to a disambiguation page, if there is ''no risk of confusion''. Ask yourself: When a reader enters this term and pushes "[[Wikipedia:Go button|Go]]", would they |
Do not disambiguate, or add a link to a disambiguation page, if there is ''no risk of confusion''. Ask yourself: When a reader enters this term and pushes "[[Wikipedia:Go button|Go]]", what article would they realistically be expecting to view as a result? Disambiguation pages are not search indices — do not add links that merely contain part of the page title where there is no significant risk of confusion. |
||
==Pages titles with multiple uses need Disambiguation links== |
|||
When a user searches for a particular term, they may have something else in mind than what actually comes up. In this case, a friendly link to the alternate article is placed at the top. For example, the article [[Star Wars]] is about the movie series, but it has a link saying |
|||
:''For the missile defense system, see [[Strategic Defense Initiative]]'' |
|||
Note that this is because "Star Wars" was a (derogatory) term for the SDI. The article [[Star]] has no such link. |
|||
If there is more than one such alternative page, create a link to a disambiguation page (see below). One of the templates shown below may be used, or a custom message such as |
|||
Adding links to non-existent articles should be done with care. There is no need for you to search for all occurrences of the page title and link to articles that are unlikely ever to be written, or if they are, likely to be removed. For example, quite a few names will show up as song titles, but with few exceptions, we usually do not write articles about individual songs, so there is no point in linking to them. If you must add this type of information, be sure to link to at least one existing article (band, album, etc.). |
|||
:''Bach redirects here. For other uses, see [[Bach (disambiguation)]]'' |
|||
which appears on the [[Johann Sebastian Bach]] page. Don't [[Wikipedia:Piped link|pipe]] the link; leave the linked article title as is. |
|||
One can also disambiguate at the bottom of the article like this: |
|||
The considerations of [[what Wikipedia is not]] are not magically invalidated for disambiguation pages. There is no point in adding one-line dictionary definitions to such a page. One exception is [[jargon]]. Disambiguation pages can list terms defined in more general articles, e.g. [[Canton (disambiguation)|Canton]] could link to [[Flag terminology]]. |
|||
:<nowiki>----</nowiki> |
|||
It is acceptable to provide short descriptions within the disambiguation page for subjects which at present do not have their own articles (see below), but this should ''never'' be done for a subject where an actual article about it would immediately end up on [[Wikipedia:Votes for deletion]]. Disambiguation descriptions should not be created for subjects whose only articles are only on pages of sister projects, even if the disambiguation page already exists (e.g., the [[Wikipedia:Disambiguation/Sep11|poll on 9/11 victims]]). Subjects which have articles on both Wikipedia and sister projects are, of course, fine. |
|||
:<nowiki>'''Horse''' is also a [[slang]] term for the [[recreational drug]] [[heroin]].</nowiki> |
|||
Some editors believe this makes them harder to find, however. |
|||
Pages of common two and three letter abbreviations group series of possible expansions for the letters, such as [[chemical symbol]]s, similar to disambiguation pages. These should be expanded beforehand. Such pages facilitate navigation and replace disambiguation pages. See '''[[Wikipedia:Disambiguation and abbreviations]]''' for details. |
|||
=== Templates for Disambiguation Links === |
|||
A number of [[Wikipedia:templates|templates]] have been created to ensure a common appearance of disambiguation links: |
|||
*{{tl|Otheruses}} |
|||
:<span class="dablink">''For other uses, see [[ArticleName (disambiguation)]].''</span> |
|||
*{{tl|Otheruses2}} |
|||
: <span class="dablink">''For other uses, see [[ DifferentArticleName (disambiguation)]].''</span> |
|||
*{{tl|Otheruses3}} to add one or two links |
|||
:<span class="dablink">''For other uses, see [[DifferentArticleName]] or [[AnotherArticleName]].''</span> |
|||
*{{tl|Otheruses-number}} for year pages |
|||
: <span class="dablink">''This article is about the year. For other uses, see [[ArticleName (number)|number 1492]].''</span> |
|||
*{{tl|Otherplaces}} |
|||
:<span class="dablink">''For other places with the same name, see [[ArticleName (disambiguation)]].''</span> |
|||
*{{tl|Otherplaces2}} <div class="dablink"> |
|||
:''For other places with the same name, see [[DifferentArticleName (disambiguation)]].'' |
|||
</div> |
|||
==Disambiguation pages== |
|||
In general, inline descriptions are problematic because links to disambiguation pages should be avoided, so they are likely to be neglected for lack of visibility. |
|||
These have links only, like this: |
|||
'''Blah''' may mean: |
|||
Common misspellings should only be listed if you would redirect to the correct title if there were no other disambiguations, and as noted above, only if the articles exist or should be written and there is a real risk of confusion, e.g., [[Kington (disambiguation)|Kington]] could include a link to [[Kingston (disambiguation)|Kingston]]. Misspellings on disambiguation pages can be listed in a separate section "Common misspellings" or "see also". Links to misspellings should not be added when no other disambiguation takes place, unless they are notable enough to be added inline in the article. |
|||
*[[Blah (book)]] |
|||
*[[Blah (movie)]] |
|||
*[[Blah (video game)]] |
|||
A disambiguation page may have a name like [[Blah (disambiguation)]] or may be named after the general term [[Blah]]; see [[#Page naming|page naming]], below. |
|||
Style for disambiguation pages is detailed at [[Wikipedia:Manual of Style (disambiguation pages)]]. Highlights: |
|||
*Put the article title in bold as an intro. |
|||
*Start each line with the link to the target page. |
|||
*Don't wikilink any other words. |
|||
*Only include references to related subject articles if the term in question actually is described on that page (for example, [[Canton]] legitimately has a link to [[Flag terminology]]). |
|||
*Include the template {{tl|disambig}} at the bottom. |
|||
You may want to disambiguate on the same page: |
|||
*''TITLE'' and ''Title'' |
|||
*''Title'' town and ''Title'' township |
|||
===What NOT to put on disambiguation pages=== |
|||
The considerations of [[what Wikipedia is not]] are not magically invalidated for disambiguation pages. Dictionary definitions don't belong here, nor do lists of articles of which the disambiguated term forms a part of the article title. If there is a separate list article, however, it makes sense to have a link to it in a "See also" section; for example, [[List of people whose first name is Michael]] should have a link from [[Michael]]. |
|||
Disambiguation pages are not intended for games of "[[Free association (psychology)|free association]]". Please use them carefully and only when needed. |
Disambiguation pages are not intended for games of "[[Free association (psychology)|free association]]". Please use them carefully and only when needed. |
||
Disambiguation descriptions should not be created for subjects whose only articles are only on pages of sister projects, even if the disambiguation page already exists (e.g., the [[Wikipedia:Disambiguation/Sep11|poll on 9/11 victims]]). However, there are templates for linking to Wiktionary; see [[Wikipedia:How to link to Wikimedia projects#Wiktionary]]. Subjects which have articles on both Wikipedia and sister projects are, of course, fine. |
|||
===Specific instances=== |
|||
====Examples==== |
|||
<span id="Specific_instances"></span> |
|||
On a page called ''Title'', generally do not disambiguate: |
On a page called ''Title'', generally do not disambiguate: |
||
* ''Title'' County |
* ''Title'' County |
||
Line 36: | Line 83: | ||
"''Title'' Island", "''Title'' River" or "River ''Title''" may be worth listing in cases where the "Island"/"River" part is often omitted. |
"''Title'' Island", "''Title'' River" or "River ''Title''" may be worth listing in cases where the "Island"/"River" part is often omitted. |
||
In most cases, do not list names of which ''Title'' is a part, unless the persons are very frequently referred to simply by their first or last name (e.g. [[Galileo]], [[Shakespeare]]). |
|||
The following paragraph of disambiguation policy is disputed and under discussion on the [[Wikipedia talk:Disambiguation|talk page]]: |
|||
===TLAs=== |
|||
:In most cases, do not list names of which ''Title'' is a part, unless the persons are very frequently referred to simply by their first or last name (e.g. [[Galileo]], [[Shakespeare]]). |
|||
Pages of common two and three letter abbreviations group series of possible expansions for the letters, such as [[chemical symbol]]s, similar to disambiguation pages. These should be expanded beforehand. Such pages facilitate navigation and replace disambiguation pages. See '''[[Wikipedia:Disambiguation and abbreviations]]''' for details. |
|||
===Multi-stub pages=== |
|||
You may want to disambiguate on the same page: |
|||
* '''Sections on one page''': Several small articles of just a paragraph or so each can co-exist on a single page, separated by headings. Although this is a disambiguation page, the disambiguation notice should not be put here as the page doesn't link to other articles with similar title. But as each [[wikipedia:section|section]] grows, there comes a point where each meaning must have a page of its own. |
|||
*''TITLE'' and ''Title'' |
|||
Although a few pages (such as [[bug (disambiguation)]]) rely on this principle, it has become more common on Wikipedia for each subject to get a separate page for its own stub. |
|||
*''Title'' town and ''Title'' township |
|||
===Issues=== |
|||
== Types of disambiguation == |
|||
In general, inline descriptions are problematic because links to disambiguation pages should be avoided, so they are likely to be neglected for lack of visibility. Common misspellings should only be listed if you would redirect to the correct title if there were no other disambiguations, and as noted above, only if the articles exist or should be written and there is a real risk of confusion, e.g., [[Kington (disambiguation)|Kington]] could include a link to [[Kingston (disambiguation)|Kingston]]. Misspellings on disambiguation pages can be listed in a separate section "Common misspellings" or "see also". Links to misspellings should not be added when no other disambiguation takes place, unless they are notable enough to be added inline in the article. |
|||
Solving this [[ambiguity]] can be done in several ways: |
|||
# Sections on one page: Several small articles of just a paragraph or so each can co-exist on a single page, separated by headings. Although this is a disambiguation page, the disambiguation notice should not be put here as the page doesn't link to other articles with similar title. But as each [[wikipedia:section|section]] grows, there comes a point where each meaning must have a page of its own. |
|||
# "Equal" disambiguation: all articles are moved to distinct names, and the "Mercury" page becomes a ''disambiguation page'' — a simple list that points to those specific articles, explaining the differences among them if necessary. See [[Wikipedia:Manual of Style (disambiguation pages)]] for style guidelines. |
|||
# "Primary topic" disambiguation: if one meaning is clearly predominant, it remains at "Mercury", the general title. The top of the article provides a link to the other meanings, or if there are a large number, to a page named "Mercury (disambiguation)". For example: the page [[Rome]] has a link at the top to a page named "[[Rome (disambiguation)]]" which lists other cities named Rome. The page [[Weblog]] has a link to the page [[server log]] at the top. |
|||
# "Disambiguated Primary topic" disambiguation: all articles are moved to distinct names. The "Mercury" page becomes a redirect to the one meaning that is clearly predominant. The top of the article provides a link to the page named "Mercury (disambiguation)". The "Mercury" redirect page can then be monitored using [[wikipedia:What links here|What links here]] for ambiguous inbound links. A change in the Primary topic is a simple redirect. For example: the page [[Fraction (mathematics)]] has a link at the top to a page named "[[Fraction (disambiguation)]]" which lists other kinds of fractions. |
|||
==Redlinks== |
|||
Creating a "Primary topic" disambiguation can prove controversial due to differing ideas on which is the primary topic. When the discussion on the matter descends into edit wars and wasted time and effort, some editors feel it is better to resort to an "equal" disambiguation page. This opinion is not shared by all. |
|||
Adding links to non-existent articles ("redlinks") should be done with care. There is no need to brainstorm all occurrences of the page title and create redlinks to articles that are unlikely ever to be written, or if they are, likely to be removed. For example, quite a few names will show up as song titles, but with few exceptions, we usually do not write articles about individual songs, so there is no point in linking to them. If you must add this type of information, be sure to link to at least one existing article (band, album, etc.). |
|||
Do include a redlink when another article links to the ambiguous article (a list of links to an article can be obtained using [[Wikipedia:What links here|Special:What links here]]) with none of the disambiguation options in mind. |
|||
Creating disambiguation pages (2, 3, 4 above) involves four steps: |
|||
# Appropriate (and distinct) titles are chosen for the specific topics. |
|||
# The disambiguation page is written. |
|||
# Any existing links to the general title are replaced by links to the appropriate specific topics. |
|||
# A link to the new disambiguation page is added to the appropriate list. (See "Links to disambiguation pages", below.) |
|||
==Page naming== |
|||
==Fixing links to disambiguated topics== |
|||
Some topics have a '''primary topic''' which editors agree is the primary meaning for the term ([[Rome]], for example). In this case the disambiguation page is named [[Rome (disambiguation)]], and the primary topic keeps the topic word or phrase. Ensure that the disambiguation page links not to the primary meaning, but to an unambiguous meaning ([[Rome, Italy]] rather than [[Rome]], for example). The ambiguous meaning might [[Wikipedia:redirect|redirect]] to the unambiguous meaning, or visa versa. |
|||
A warning, though: people have a tendency to create disambiguation pages without fixing all the links to them. The result is that Wikipedia is left in a worse state than it was before the page was split. |
|||
Before creating a disambiguation page, click on "What links here" to find all the pages that link to the page you are about to change. Make sure those pages are fixed or that they won't be adversely affected before you do the split. |
|||
'''A code of honor for creating disambiguation pages is to fix the mis-directed links that will be created when the disambiguation page is made.''' |
|||
Rather than doing this manually, there is a tool to facilitate this in the [http://sourceforge.net/projects/pywikipediabot/ Python Wikipedia Robot], occasionally run by e.g. [[User:Robbot]]. The bot offers to update links to choices listed on the disambiguation page. |
|||
In other cases, where there is no such consensus, disambiguation pages are named after the topic itself ([[Table]], for example). |
|||
== Topic articles == |
|||
For creating the specific topic pages, a few options are available. If there's an alternate name or more complete name that is equally clear, that can be used. |
|||
===Topic page naming=== |
|||
For example, [[Java programming language]], [[Titan rocket]]. Otherwise, a disambiguating word or phrase can be added in parentheses. The word or phrase in parentheses should be one of two things: a generic noun describing what the specific title is an instance of (for example, [[Mercury (element)]], [[Seal (mammal)]]); or the ''subject'' or ''context'' to which the term applies (for example, [[Union (set theory)]], [[Inflation (economics)]]). |
|||
For creating the specific topic pages, a few options are available. If there's an alternate name or more complete name that is equally clear, that can be used. For example, [[Java programming language]], [[Titan rocket]]. Otherwise, a disambiguating word or phrase can be added in parentheses. The word or phrase in parentheses should be one of two things: a generic noun describing what the specific title is an instance of (for example, [[Mercury (element)]], [[Seal (mammal)]]); or the ''subject'' or ''context'' to which the term applies (for example, [[Union (set theory)]], [[Inflation (economics)]]). |
|||
Rarely, an adjective describing the title can be used, but in this case it's usually better to rephrase the title to avoid parentheses. If there's a choice between using a short phrase and word with context (for example, "Mathematical analysis" vs. "Analysis (mathematics)", there is no hard rule about which is preferred, and one can often create both, one redirecting to the other. |
Rarely, an adjective describing the title can be used, but in this case it's usually better to rephrase the title to avoid parentheses. If there's a choice between using a short phrase and word with context (for example, "Mathematical analysis" vs. "Analysis (mathematics)", there is no hard rule about which is preferred, and one can often create both, one redirecting to the other. |
||
Line 82: | Line 117: | ||
For more on which word or phrase to insert in the parentheses, see [[Wikipedia:Naming conventions]] and [[Wikipedia talk:Naming conventions]]. |
For more on which word or phrase to insert in the parentheses, see [[Wikipedia:Naming conventions]] and [[Wikipedia talk:Naming conventions]]. |
||
==Fixing links to disambiguated topics== |
|||
== The disambiguation page == |
|||
'''A code of honor for creating disambiguation pages is to fix the mis-directed links that will be created when the disambiguation page is made.''' |
|||
{{main article|Wikipedia:Manual of Style (disambiguation pages)}} |
|||
This section describes and compares a couple of popular approaches. |
|||
Before creating a disambiguation page, click on "What links here" to find all the pages that link to the page you are about to change. Make sure those pages are fixed or that they won't be adversely affected before you do the split. |
|||
As mentioned earlier, if the title clearly has one central most important meaning, and one or two lesser-known meanings in narrow contexts, it is probably better to have the full article about the primary meaning under the simple title, after brief links to the special uses. For example, the [[poker]] article covers the card game; it's likely that most people visiting that article are interested in the game rather than in [[fireplace poker]]s. For this reason, we link to [[fireplace poker]] from the existing poker article instead of moving that article to "Poker (game)". |
|||
Rather than doing this manually, there is a tool to facilitate this in the [http://sourceforge.net/projects/pywikipediabot/ Python Wikipedia Robot], occasionally run by e.g. [[User:Robbot]]. The bot offers to update links to choices listed on the disambiguation page. Bots are one of the reasons for limited number of links in the [[Wikipedia:Manual of Style (disambiguation pages)]]. |
|||
If a disambiguation page ''is'' merited, it can be as simple as a bullet list of specific articles with links and perhaps a brief one-line description of each (saving details for the specific articles), or it might have some explanatory text of its own if differences need to be explained, or if there is interesting history of the term itself independent of the specific topics (in the latter cases, a definition list may be preferable to a bullet list). Include the template '''<nowiki>{{</nowiki>disambig}}'''. See [[Wikipedia:Manual of Style (disambiguation pages)]] for a more specific guide to the layout of such pages. If each of the topic pages themselves only consist of a sentence or two, it may be simpler just to put all of them together in one article. |
|||
Which method is appropriate will depend on the nature of the subject. The articles below serve as examples of what can be done (and a few examples of what shouldn't be done, but hopefully not many). Note that a disambiguating page may look a lot like a dictionary entry. We try to maintain a policy that [[Wikipedia:Wikipedia is not a dictionary|Wikipedia is not a dictionary]], so resist the urge to make such pages even more dictionary-like than they already are (for example, there's no need to put etymologies or pronunciations, unless those serve to clarify the topics). |
|||
If you're not making a whole disambiguation page you can put a notice at the top of a page; some examples: |
|||
On [[server]]: |
|||
:<nowiki>: ''This article is about computer servers. For the food service use, see [[waiter]].''</nowiki> |
|||
Or (short version at the top of the page) |
|||
On [[California]]: |
|||
:<nowiki>: ''For other uses: see [[California (disambiguation)]].''</nowiki> |
|||
The effect as above can be more easily achieved by typing <nowiki>{{otheruses}}</nowiki> instead. This template will automatically create the needed link by appending the ''(disambiguation)'' part to the name of the current article. |
|||
One can also disambiguate at the bottom of the article like this: |
|||
:<nowiki>----</nowiki> |
|||
:<nowiki>'''Horse''' is also a [[slang]] term for the [[recreational drug]] [[heroin]].</nowiki> |
|||
Disambiguation will appear below a horizontal line, when using the format shown above. |
|||
== Links to disambiguation pages == |
== Links to disambiguation pages == |
||
There is rarely any need for links directly to disambiguation pages |
There is rarely any need for links directly to disambiguation pages—except from the primary topic, if any—in most cases links should point to the article that deals with the specific meaning intended, and not to a disambiguation page. Before making a page into a disambiguation page one should first look at each page that links to it (using the "pages that link here" feature of the software) and correct the links as appropriate. Of course, the whole point of making a disambiguation page is so that accidental links made to it will make sense, so it's not a major problem if there are still links to it. |
||
The Wikipedia software has a feature that lists "[[special:Lonelypages|orphan]]" pages; that is, pages that no other page links to. But for disambiguating pages, that's perfectly correct: we usually want pages to link to the more specific pages. |
The Wikipedia software has a feature that lists "[[special:Lonelypages|orphan]]" pages; that is, pages that no other page links to. But for disambiguating pages, that's perfectly correct: we usually want pages to link to the more specific pages. |
||
Line 131: | Line 144: | ||
Pure disambiguation pages should only contain interlanguage links if a similar problem of disambiguation exists in the target language; that is, they should not point to a single meaning from the list of meanings but to another disambiguation page. |
Pure disambiguation pages should only contain interlanguage links if a similar problem of disambiguation exists in the target language; that is, they should not point to a single meaning from the list of meanings but to another disambiguation page. |
||
==CSS== |
|||
Depending on your [[Cascading_Style_Sheets|CSS]] settings for class div.boilerplate#disambig the disambiguation message looks like this: |
|||
{{disambig}} |
|||
If you do not have it displayed, you can still see that a page is marked as disambiguation page, from the category indication. |
|||
See also [[Wikipedia:Stub and disambiguation message example]]. |
|||
== See also == |
== See also == |
||
* [[Wikipedia:Disambiguation |
* [[Wikipedia:Disambiguation pages with links]], an active Wiki fixup project |
||
* [[Wikipedia:Disambiguation pages with links]] |
|||
* [[Wikipedia:Disambiguation and abbreviations]] |
* [[Wikipedia:Disambiguation and abbreviations]] |
||
* [[Wikipedia:Contributing FAQ]] |
* [[Wikipedia:Contributing FAQ]] |
Revision as of 00:15, 18 August 2005
This page documents an English Wikipedia guideline. Editors should generally follow it, though exceptions may apply. Substantive edits to this page should reflect consensus. When in doubt, discuss first on this guideline's talk page. |
[[Category:Wikipedia {{{1}}}s|Disambiguation]]
- For style guidelines, see Manual of Style (disambiguation pages)
Disambiguation in Wikipedia and Wikimedia is the process of resolving ambiguity—meaning the conflicts that occur when articles about two or more different topics have the same "natural" title. In other words, disambiguations are types of turnpikes that lead to different meanings of a related word.
Wikipedia thrives on the fact that making links is simple and automatic: as you're typing in an edit window, put brackets around Mercury (like this: [[Mercury]]) and you'll have a link. But were you intending to link to Mercury the element, the planet, the automobile brand, the record label, the NASA manned-spaceflight project, or the Roman god?
Disambiguation should not be confused with the merging of duplicate articles (articles with different titles, but regarding the very same topic, for example "Gas Turbine" and "Gas turbine", or "loo" and "restroom").
Two different methods of disambiguating are discussed here: disambiguation links and disambiguation pages. In the first case, an article discussing one particular meaning of a term has a link at the top (or, rarely, at the bottom) pointing the user to another page with a similar title. A disambiguation page contains no article content, only links to other Wikipedia pages.
When to disambiguate
Disambiguation serves a single purpose: to let the reader choose among different pages that might reside under the same title.
Do not disambiguate, or add a link to a disambiguation page, if there is no risk of confusion. Ask yourself: When a reader enters this term and pushes "Go", what article would they realistically be expecting to view as a result? Disambiguation pages are not search indices — do not add links that merely contain part of the page title where there is no significant risk of confusion.
Pages titles with multiple uses need Disambiguation links
When a user searches for a particular term, they may have something else in mind than what actually comes up. In this case, a friendly link to the alternate article is placed at the top. For example, the article Star Wars is about the movie series, but it has a link saying
- For the missile defense system, see Strategic Defense Initiative
Note that this is because "Star Wars" was a (derogatory) term for the SDI. The article Star has no such link.
If there is more than one such alternative page, create a link to a disambiguation page (see below). One of the templates shown below may be used, or a custom message such as
- Bach redirects here. For other uses, see Bach (disambiguation)
which appears on the Johann Sebastian Bach page. Don't pipe the link; leave the linked article title as is.
One can also disambiguate at the bottom of the article like this:
- ----
- '''Horse''' is also a [[slang]] term for the [[recreational drug]] [[heroin]].
Some editors believe this makes them harder to find, however.
Templates for Disambiguation Links
A number of templates have been created to ensure a common appearance of disambiguation links:
- {{Otheruses}}
- For other uses, see ArticleName (disambiguation).
- {{Otheruses2}}
- For other uses, see DifferentArticleName (disambiguation).
- {{Otheruses3}} to add one or two links
- For other uses, see DifferentArticleName or AnotherArticleName.
- {{Otheruses-number}} for year pages
- This article is about the year. For other uses, see number 1492.
- {{Otherplaces}}
- For other places with the same name, see ArticleName (disambiguation).
- {{Otherplaces2}}
- For other places with the same name, see DifferentArticleName (disambiguation).
Disambiguation pages
These have links only, like this:
Blah may mean:
A disambiguation page may have a name like Blah (disambiguation) or may be named after the general term Blah; see page naming, below.
Style for disambiguation pages is detailed at Wikipedia:Manual of Style (disambiguation pages). Highlights:
- Put the article title in bold as an intro.
- Start each line with the link to the target page.
- Don't wikilink any other words.
- Only include references to related subject articles if the term in question actually is described on that page (for example, Canton legitimately has a link to Flag terminology).
- Include the template {{disambig}} at the bottom.
You may want to disambiguate on the same page:
- TITLE and Title
- Title town and Title township
What NOT to put on disambiguation pages
The considerations of what Wikipedia is not are not magically invalidated for disambiguation pages. Dictionary definitions don't belong here, nor do lists of articles of which the disambiguated term forms a part of the article title. If there is a separate list article, however, it makes sense to have a link to it in a "See also" section; for example, List of people whose first name is Michael should have a link from Michael.
Disambiguation pages are not intended for games of "free association". Please use them carefully and only when needed.
Disambiguation descriptions should not be created for subjects whose only articles are only on pages of sister projects, even if the disambiguation page already exists (e.g., the poll on 9/11 victims). However, there are templates for linking to Wiktionary; see Wikipedia:How to link to Wikimedia projects#Wiktionary. Subjects which have articles on both Wikipedia and sister projects are, of course, fine.
Examples
On a page called Title, generally do not disambiguate:
- Title County
- Title City
- Title Hospital
- Title University
"Title Island", "Title River" or "River Title" may be worth listing in cases where the "Island"/"River" part is often omitted.
In most cases, do not list names of which Title is a part, unless the persons are very frequently referred to simply by their first or last name (e.g. Galileo, Shakespeare).
TLAs
Pages of common two and three letter abbreviations group series of possible expansions for the letters, such as chemical symbols, similar to disambiguation pages. These should be expanded beforehand. Such pages facilitate navigation and replace disambiguation pages. See Wikipedia:Disambiguation and abbreviations for details.
Multi-stub pages
- Sections on one page: Several small articles of just a paragraph or so each can co-exist on a single page, separated by headings. Although this is a disambiguation page, the disambiguation notice should not be put here as the page doesn't link to other articles with similar title. But as each section grows, there comes a point where each meaning must have a page of its own.
Although a few pages (such as bug (disambiguation)) rely on this principle, it has become more common on Wikipedia for each subject to get a separate page for its own stub.
Issues
In general, inline descriptions are problematic because links to disambiguation pages should be avoided, so they are likely to be neglected for lack of visibility. Common misspellings should only be listed if you would redirect to the correct title if there were no other disambiguations, and as noted above, only if the articles exist or should be written and there is a real risk of confusion, e.g., Kington could include a link to Kingston. Misspellings on disambiguation pages can be listed in a separate section "Common misspellings" or "see also". Links to misspellings should not be added when no other disambiguation takes place, unless they are notable enough to be added inline in the article.
Redlinks
Adding links to non-existent articles ("redlinks") should be done with care. There is no need to brainstorm all occurrences of the page title and create redlinks to articles that are unlikely ever to be written, or if they are, likely to be removed. For example, quite a few names will show up as song titles, but with few exceptions, we usually do not write articles about individual songs, so there is no point in linking to them. If you must add this type of information, be sure to link to at least one existing article (band, album, etc.).
Do include a redlink when another article links to the ambiguous article (a list of links to an article can be obtained using Special:What links here) with none of the disambiguation options in mind.
Page naming
Some topics have a primary topic which editors agree is the primary meaning for the term (Rome, for example). In this case the disambiguation page is named Rome (disambiguation), and the primary topic keeps the topic word or phrase. Ensure that the disambiguation page links not to the primary meaning, but to an unambiguous meaning (Rome, Italy rather than Rome, for example). The ambiguous meaning might redirect to the unambiguous meaning, or visa versa.
In other cases, where there is no such consensus, disambiguation pages are named after the topic itself (Table, for example).
Topic page naming
For creating the specific topic pages, a few options are available. If there's an alternate name or more complete name that is equally clear, that can be used. For example, Java programming language, Titan rocket. Otherwise, a disambiguating word or phrase can be added in parentheses. The word or phrase in parentheses should be one of two things: a generic noun describing what the specific title is an instance of (for example, Mercury (element), Seal (mammal)); or the subject or context to which the term applies (for example, Union (set theory), Inflation (economics)).
Rarely, an adjective describing the title can be used, but in this case it's usually better to rephrase the title to avoid parentheses. If there's a choice between using a short phrase and word with context (for example, "Mathematical analysis" vs. "Analysis (mathematics)", there is no hard rule about which is preferred, and one can often create both, one redirecting to the other.
A special case of using a "context" to disambiguate is when the context is a book or other creative work, such as with articles about fictional characters. However, we don't really want lots of twisty little stubs about fictional characters: check your fiction. If there is a choice between disambiguating with a generic term or with a context, choose whichever is simpler. For example "mythology" rather than "mythological figure". Use the same disambiguating phrase for topics within the same context.
To conform to our normal naming conventions, the phrase in parentheses should be treated just as any other word in a title: normally lowercase, unless it is a proper noun that always appears capitalized even in running text (such as a book title).
For more on which word or phrase to insert in the parentheses, see Wikipedia:Naming conventions and Wikipedia talk:Naming conventions.
Fixing links to disambiguated topics
A code of honor for creating disambiguation pages is to fix the mis-directed links that will be created when the disambiguation page is made.
Before creating a disambiguation page, click on "What links here" to find all the pages that link to the page you are about to change. Make sure those pages are fixed or that they won't be adversely affected before you do the split.
Rather than doing this manually, there is a tool to facilitate this in the Python Wikipedia Robot, occasionally run by e.g. User:Robbot. The bot offers to update links to choices listed on the disambiguation page. Bots are one of the reasons for limited number of links in the Wikipedia:Manual of Style (disambiguation pages).
Links to disambiguation pages
There is rarely any need for links directly to disambiguation pages—except from the primary topic, if any—in most cases links should point to the article that deals with the specific meaning intended, and not to a disambiguation page. Before making a page into a disambiguation page one should first look at each page that links to it (using the "pages that link here" feature of the software) and correct the links as appropriate. Of course, the whole point of making a disambiguation page is so that accidental links made to it will make sense, so it's not a major problem if there are still links to it.
The Wikipedia software has a feature that lists "orphan" pages; that is, pages that no other page links to. But for disambiguating pages, that's perfectly correct: we usually want pages to link to the more specific pages.
So, in order to make the orphans list more useful by not cluttering it with intentional orphans, disambiguation pages are linked from either
- Multiple-place names for place names
- Links to disambiguating pages or Links to (disambiguation) pages for other such pages.
- People are also included on Non-unique personal name.
Special:Whatlinkshere/Template:Disambig (previously "Special:Whatlinkshere/MediaWiki:Disambig") could list all disambiguation pages, but the Wiki software limits the number of results listed to 500 in order to reduce technical strain on the servers. The Category:Disambiguation provides a complete list, but it is also hard on the servers (given that we have over 7,000 of them).
If you create a disambiguation page, put a link to it in one of those pages as appropriate.
If you must link to a disambiguation page (instead of a specific meaning), link to a redirect to the disambiguation page that includes the text "(disambiguation)", e.g. America (disambiguation). This helps in distinguishing accidental links to the disambiguation page from intentional ones.
Interlanguage links
Pure disambiguation pages should only contain interlanguage links if a similar problem of disambiguation exists in the target language; that is, they should not point to a single meaning from the list of meanings but to another disambiguation page.