Wikipedia:Hatnote: Difference between revisions

From Wikipedia, the free encyclopedia
Content deleted Content added
deleting hatnote to obscure essay, for same reason it was deleted in 2014 after this discussion
→‎top: four basic rules
Line 2: Line 2:


'''Hatnotes''' are short notes placed at the top of an article or section of an article (hence the name "[[hat]]"). Hatnotes help readers locate a different article they might be seeking. Readers may have arrived at the article containing the hatnote because they were [[WP:redirect|redirected]], because the sought article uses a more specific, [[WP:DAB|disambiguated]] title, or because the sought article and the article with the hatnote have similar names. Hatnotes provide [[WP:Internal link|links]] to the possibly sought article or to a [[WP:disambiguation page|disambiguation page]].
'''Hatnotes''' are short notes placed at the top of an article or section of an article (hence the name "[[hat]]"). Hatnotes help readers locate a different article they might be seeking. Readers may have arrived at the article containing the hatnote because they were [[WP:redirect|redirected]], because the sought article uses a more specific, [[WP:DAB|disambiguated]] title, or because the sought article and the article with the hatnote have similar names. Hatnotes provide [[WP:Internal link|links]] to the possibly sought article or to a [[WP:disambiguation page|disambiguation page]].

The four basic rules of hatnotes are:

#Link directly to other articles and disambiguation pages; do not [[WP:PIPING|pipe]] non-disambiguation links. Linking to redirects is typically not preferred, though of course exceptions can occur.
#Keep explanations to a minimum; only explain vital information, trusting instead in the article lead to clarify things for the reader.
#Only mention other topics and articles if there is a large possibility of a reader arriving at the article either by mistake or with another topic in mind.
#If at all possible, limit hatnotes to just one per page.


For more information about methods of disambiguating articles, see [[Wikipedia:Disambiguation]]. Please note that the section [[Wikipedia:Hatnote#Hatnote templates|Hatnote templates]] in this page is [[WP:transclusion|transcluded]] from [[Template:Hatnote templates documentation]].
For more information about methods of disambiguating articles, see [[Wikipedia:Disambiguation]]. Please note that the section [[Wikipedia:Hatnote#Hatnote templates|Hatnote templates]] in this page is [[WP:transclusion|transcluded]] from [[Template:Hatnote templates documentation]].

Revision as of 20:19, 29 July 2015

Hatnotes are short notes placed at the top of an article or section of an article (hence the name "hat"). Hatnotes help readers locate a different article they might be seeking. Readers may have arrived at the article containing the hatnote because they were redirected, because the sought article uses a more specific, disambiguated title, or because the sought article and the article with the hatnote have similar names. Hatnotes provide links to the possibly sought article or to a disambiguation page.

The four basic rules of hatnotes are:

  1. Link directly to other articles and disambiguation pages; do not pipe non-disambiguation links. Linking to redirects is typically not preferred, though of course exceptions can occur.
  2. Keep explanations to a minimum; only explain vital information, trusting instead in the article lead to clarify things for the reader.
  3. Only mention other topics and articles if there is a large possibility of a reader arriving at the article either by mistake or with another topic in mind.
  4. If at all possible, limit hatnotes to just one per page.

For more information about methods of disambiguating articles, see Wikipedia:Disambiguation. Please note that the section Hatnote templates in this page is transcluded from Template:Hatnote templates documentation.

Placement

Hatnotes are placed at the very top of the article, before any other items such as images, navigational templates and maintenance templates (like the "cleanup", "unreferenced", and "POV" templates). Text-only browsers and screen readers present the page sequentially. If a reader has reached the wrong page, they typically want to know that first.

Format

In most cases, hatnotes should be created using a standard hatnote template as illustrated below. This permits the form and structure of hatnotes to be changed uniformly across the encyclopedia as needed and the templates to be excluded in print.

Current Wikipedia style is to italicize and to indent each note, without a bullet before the item. A horizontal dividing line should neither be placed under a note nor after the final item in a list.

When determining the content of the hatnote, keep in mind that it forms part of the user interface rather than the article content. Two applicable user interface design principles are clarity and conciseness. The hatnote should not overload the user with extraneous information, and the content should be imparted quickly and accurately. These design goals are conveyed succinctly in the artistic principle less is more.

Length

As hatnotes separate the reader from the content they are looking for, hatnotes should generally be as concise as possible. Long explanations are generally discouraged; the article's lead text, not the hatnote, should explain what the article is about. In almost all cases, the hatnote is intended only to direct readers to other articles in case they were actually looking for something they will not find in the article containing the hatnote.

To shorten hatnotes, generally they should only list disambiguation pages (X (disambiguation)) if the article is at X or if X redirects to that article. If X is a disambiguation page and the article is at X (letter), then X (letter) generally needs no hatnote. Direct links to other articles should be limited to circumstances immediately following a page move or redirect change or if the other article could be reasonably expected by a significant number of readers to be at the title in question: for instance, Turkey is about the country, but many readers reasonably expect to find the article on the bird at that title; therefore, the hatnote there correctly reads

{{two other uses|the country|the bird|Turkey (bird)}}

which renders

This article is about the country. For the bird, see Turkey (bird). For other uses, see Turkey (disambiguation).

One single hatnote is greatly preferred to two (or worse, more). There are many different templates that can easily accommodate several links; use one of them rather than two hatnote templates.

Summarize or not?

Some hatnote disambiguation templates include a brief summary of the present article's topic; others do not have a summary. For instance, in the article Honey, one might use the template {{about|the insect-produced fluid}} to produce:

This article is about the insect-produced fluid. For other uses of the term, see Honey (disambiguation).

Alternatively, one might use {{other uses}} to produce:

For other uses, see Honey (disambiguation).

Either of these two styles is acceptable. The choice of style in a given article is based on editors' preferences and on what is likely to be clearer and easier for the reader. (In this particular instance, most English speakers will know what honey is, and the second, more concise hatnote is preferable.) Where an article already has a hatnote in one of these styles, editors should not change it to the other style without good reason.

Examples of proper use

Two articles with similar titles

This article is about the village in England. For H. P. Lovecraft's fictional town, see Dunwich (Lovecraft).

Dunwich (/ˈdʌnɪ/) is a town in the county of Suffolk in England, the remnant of what was once a prosperous seaport and centre of the wool trade during the early middle ages, with a natural harbour formed by the mouths of the River Blyth...

When two articles share the same title, except that one is disambiguated and the other not, the undisambiguated article should include a hatnote with a link to the other article. It is not necessary to create a separate disambiguation page. {{about}} may be used for this. In this case the parameterization was {{about|the village in England|H. P. Lovecraft's fictional town|Dunwich (Lovecraft)}}.

Linking to a disambiguation page

For other uses, see Monolith (disambiguation).

A monolith is a monument or natural feature such as a mountain, consisting of a single massive stone or rock. Erosion usually exposes these formations...

When a term has a primary meaning and two or more additional meanings, the hatnote on the primary topic page should link to a disambiguation page. {{other uses}} may be used for this.

In many cases the hatnote also includes a brief description of the subject of the present article, for readers' convenience:

This article is about the maze-like labyrinth from Greek mythology. For other uses, see Labyrinth (disambiguation).

In Greek mythology, the Labyrinth was an elaborate maze-like structure constructed for King Minos of Crete and designed by the legendary artificer Daedalus to hold the Minotaur...

The template {{about}} may be used for this. In this case the parameterization was {{about|the mazelike labyrinth from Greek mythology}}.

Ambiguous term that redirects to an unambiguously named article

{{redirect}}, or a related template, can be used when an ambiguous title is redirected to an unambiguous title or a primary topic article:

Johann Sebastian Bach


From Wikipedia, the free encyclopedia
(Redirected from Bach)

"Bach" redirects here. For other uses, see Bach (disambiguation).

Johann Sebastian Bach (German pronunciation: [joˈhan/ˈjoːhan zeˈbastjan ˈbax]; March 21, 1685 O.S.July 28, 1750 N.S.) was a prolific German composer...

Hatnote(s) above maintenance tags

You always place a hatnote above anything, including maintenance tags.

For the 2014 film adaptation, see The Giver (film).

The Giver is a 1993 American Young-adult fiction-Dystopian novel by Lois Lowry. It is set in a society which at first appears as a utopian society but then later revealed to be a dystopian one as the story progresses. The novel follows a boy named Jonas...

Examples of improper use

Trivial information, dictionary definitions, and slang

When notes feature a trivial detail or use of a term, or links to overly specific and tendentious material, they are unwarranted.

A previous version of the article Investment showed:

During a siege to invest a town or fortress means to surround it with a contravallation and a circumvallation.

Investment is a term with several closely related meanings in finance and economics. It refers to the accumulation of some kind of asset in hopes of getting a future return from it...

In this case, there is no direct disambiguation, and the note listed is bound to be uninteresting to most readers. The proper disambiguation simply links to a separate Invest (disambiguation) page.

Legitimate information about the topic

A previous version of the Aisha article showed:

Ayesha is sometimes used as a woman's name. Once popular only among Muslims, it was briefly popular among English-speakers after it appeared in the book She by Rider Haggard.

Aisha or Ayesha (Arabic عائشه `ā'isha = "she who lives") was a wife of the Islamic prophet Muhammad...

This is a typical and highly improper misuse of disambiguating hatnotes. Instead, the information belongs in the body of the article, or in the articles about the book, or in a separate article about names, or all three places. Hatnotes are meant to reduce confusion and direct readers to another article they might have been looking for, not for information about the subject of the article itself.

Linking to articles that are related to the topic

Disambiguation hatnotes are intended to link to separate topics that could be referred to by the same title. They are not intended to link to topics that are simply related to each other, or to a specific aspect of a general topic:

This article is about the scientific study of extraterrestrial life. For treatment in popular culture, see Extraterrestrial life in popular culture.

Extraterrestrial life is life that may exist and originate outside the planet Earth. Its existence is currently hypothetical: there is as yet no evidence of extraterrestrial life that has been widely accepted by scientists...

Instead of using a disambiguation hatnote in such cases, it is better to summarize Extraterrestrial life in popular culture under a subsection of Extraterrestrial life in conjunction with the {{main}} template, and perhaps link to it in the See also section, as well.

This guideline does not discourage the use of disambiguation hatnotes in a situation where separate topics are related, but could nonetheless be referred to by the same title and would thus qualify for disambiguation, such as a book and its film adaptation.

Disambiguating article names that are not ambiguous

In many cases it is preferable not to have a hatnote when the name of the article is not ambiguous.

Tree (set theory)


For other uses, see Tree (disambiguation).

In set theory, a tree is a partially ordered set (poset) in which there is a single unique minimal element (called the root) and in which the set of elements less than a given element is well ordered...

Here the hatnote can be removed. A reader who is following links within Wikipedia is unlikely to end up at tree (set theory) if one were looking for other types of trees, since tree does not redirect there.

A hatnote may still be appropriate when even a more specific name is still ambiguous. For example, Matt Smith (comics) might still be confused with the comics illustrator Matt Smith (illustrator).

The presence or absence of hatnotes in articles with disambiguated titles has been a contentious issue, and this guideline doesn't prescribe one way or the other. There are cases where some editors strongly believe that such hatnotes should be included, such as the various articles about treaties called Treaty of Paris.

A hatnote may be appropriate in an unambiguously named article when an ambiguous term redirects to it, as explained in the "Proper uses" section above.

Extraneous links

Each additional link in the hatnote besides the ambiguous or confusable topic(s) makes it more difficult to find the desired target. For example:

WTIX (980 AM) is a radio station broadcasting a Sports radio format.

In this case, the link to New Orleans, Louisiana, in the hatnote leads to an article that is not ambiguous with the title. Linking only to the possible other destination (WIST (AM)) makes it easier to find the link.

External links

A previous version of the Hurricane Katrina article contained:

If you are trying to locate someone missing in Hurricane Katrina, or register yourself as found, you can use the site www.disastersearch.org [1]

Hurricane Katrina, which made landfall near New Orleans, Louisiana, on August 29, 2005, was one of the most destructive and expensive tropical cyclones to hit the United States...

The use of external help links in Wikipedia, though noble, cannot reasonably be maintained. In special cases, a link to an "External links" section may be appropriate, but POV favoritism can be obstructive. In this case, the hatnote was removed entirely.

Non-existent articles

Hatnotes should not contain red links to non-existent articles since hatnotes are intended to help users navigate to another article they may have intended to find. The exception is if one intends to create the linked article immediately. In that case, consider creating the new article first, before saving the addition of the hatnote.