Help:Extension:Disambiguator

Disambiguation pages are pages that list links to more specific pages on a given topic. Since in MediaWiki page titles are unique, there may be multiple pages that could refer to a given word or phrase that a reader searches for. It is in this situation that disambiguation pages are often used, to help mitigate the ambiguity and accessibility to pages with similar but distinct titles.

An example to explain the need for a disambiguation page refers to the topic of New York. The topic could refer to a myriad of more specific topics such as New York City, the state of New York, or a magazine by the title of New York. If a user simply searches for "New York", they are brought to the disambiguation page from which they can find the topic they were looking for.

Disambiguation pages typically do not by themselves describe specific content, they only lead to more pages on the topic. A list of all disambiguation pages on a wiki can be found at Special:DisambiguationPages, while pages linking to disambiguation pages are listed at Special:DisambiguationPageLinks.

When to link to disambiguation pages
In most cases, the goal is to cite a link to a page with specific content. This makes it so that it is usually undesirable to link to a disambiguated term. Links in these cases meant to instead point to a more specific page rather than the term's disambiguation page. The Disambiguator extension has some features that make it easier to reduce the number of unwanted links to disambiguation pages.

Reducing links to disambiguation pages
Pages that contain links to disambiguation pages are listed at Special:DisambiguationPageLinks. In addition, Disambiguator provides other features that can help reduce the number of links to disambiguation pages:

Warning editors about linking to disambiguation pages
When using WikiEditor (also known as the 2010 wikitext editor), a notification warns editors about potential risk of linking to a disambiguated page without intending to do so. The notification contains a "Review link" that once clicked, will prompt the editor to correct the link to a more specific term.

Revision tag
Edits that add links to disambiguation pages are given the  revision tag. Patrollers can filter Special:RecentChanges and Special:Watchlist to show only changes that have this tag, making it easier to find and fix the links.

CSS class
Disambiguator adds the CSS class  to links to disambiguation pages. The color of these links can then easily be changed through CSS (such as through MediaWiki:Common.css or individual user CSS), for instance with: With these colored differently than normal links, it is easier for patrollers to spot and fix the links.