Help:Disambiguation

Disambiguation pages are used to resolve conflicts that occur between article titles when a single term can be associated with more than one topic, making that term likely to be the natural title for more than one article. Disambiguation pages lead to the different articles that would, if this was possible, have the same title.

There are three main disambiguation scenarios:

  • A page is a disambiguation page, leading to all the alternative uses of the title.
  • The page is about one usage, or redirects to a page that is about one usage, which is called the primary topic. In such cases, the {{redirect}} or the {{rellink}} template should be used at the top of the page to guide readers to a disambiguation page that lists alternative uses. (disambiguation pages usually end with "(disambiguation)")
  • The page is about the primary topic or redirects to a page that is about the primary topic and there is only one other use. The other use, since there is only one, is linked directly to using the {{redirect}} or the {{rellink}} template without any disambiguation page.

Links that point to a disambiguation page rather than one of the pages it lists should be modified, unless this is not a mistake, to point to the intended destination.

Disambiguation rules

In order to make linking to pages in the main namespace as natural as possible, to avoid breaking existing links and to make search results more relevant, the following rules should be followed for pages in the main namespace with a name that is shared (or not) by many articles:

  • If there is only one article, the page should redirect to that article.
  • If there are many articles...
    • If none of the articles is an API documentation page, the page should be a disambiguation page providing a list of the articles.
    • If many of the articles are API documentation pages, the page should be a disambiguation page providing a list of the articles.
      • This can be automated with the {{member disambig}} template
      • However, if one of the API pages concerned is about a member or a class that is significantly more common than the others, the page should redirect to that page instead.
    • If (only) one of the articles is an API documentation page, the page should redirect to that page.
  • In all cases, if the page redirects to an article and there are other articles that share the name of the page, these other articles should be referred from the article that the page redirects to with the {{redirect}} template.
    • If there are more than three other articles, the {{redirect}} template should be used to link to a page in the main namespace with the name that is common to the articles but suffixed with " (disambiguation)". That page should be a disambiguation page providing a list of the articles, including the article to which the page redirects.
  • When intentionally linking to a disambiguation page, a redirect should be created at the page suffixed with " (disambiguation)", and that page linked to.