View source for Template:Distinguish/doc

{{Documentation subpage}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
{{Shortcut|Confuse|Not to be confused with}}

== Usage ==
<code><nowiki>{{distinguish|Villager}}</nowiki></code> {{distinguish|Villager}}

<code><nowiki>{{distinguish|Villager|Illager}}</nowiki></code> {{distinguish|Villager|Illager}}

<code><nowiki>{{distinguish|Villager|Illager|Pillager}}</nowiki></code> {{distinguish|Villager|Illager|Pillager}}

This hatnote is generally used when there can be confusion with a similar term. This is typically used when readers have misspelled their desired title, and the error would be apparent by simply displaying the alternative term without further explanation.  For example, consider a reader looking for the fish who instead ends up at [[cow]]: 
<blockquote>[[Cow]] → {{Distinguish|Cod}}</blockquote>

Readers are presumed to recognize that they actually wanted ''comma'' by merely looking at the spelling, and this case generally requires no further explanation.

However, {{tcode|distinguish}} is not suitable when the difference is not readily apparent without additional details. Consider a reader looking for:
<blockquote>[[File:Red x.svg|15px|link=]] [[Void]] → {{Distinguish|The Void}} </blockquote>

In the above hatnote, it is not generally apparent how the suggested "The Void" is different from Void.
<blockquote>[[File:Green check.svg|15px|link=]]  [[Void]] → {{About|the empty space below the Minecraft world|the biome|The Void}}</blockquote>

Using {{tl|about}} instead of {{tcode|distinguish}}, the differences in the suggested article is explained upfront without requiring the reader to click through and differentiate the terms on their own.

{{tcode|Distinguish}} should only be used when the ambiguity exists for a portion of the readership that is sufficient to warrant a hatnote. Care should be taken to [[WP:TRHAT|avoid trivial uses]].

== See also ==
* {{tl|About}}, links the reader to other articles with similar titles or concepts that they may have been seeking instead. 

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
<!-- Categories and interwikis go to /doc subpage -->
[[Category:Disambig templates]]


}}
</includeonly>
<noinclude>
<!-- doc categories/interwikis -->

</noinclude>