Wikipedia:Manual of Style/Organizing disambiguation pages by subject area

From Wikipedia, the free encyclopedia
Readers should be able to navigate down to what they want in one pass, without having to read any heading or entry more than once.

On large disambiguation pages, organizing by subject area helps readers find the page they want.

Readers should be able to find their target with minimal reading, by:

  1. Identifying the relevant section from level 2 headers, then
  2. Identifying the relevant subsection (if present) from level 3 (and deeper) headers, then
  3. Identifying the topic they want from the entries in that (sub)section

without having to descend into irrelevant sections, and without having to read anything twice. This page discusses three principles that enable that goal, and suggested headings to use.

Guidance for individual entries is at Wikipedia:Manual of Style/Disambiguation pages.

Principles[edit]

1. Clearly defined subject areas[edit]

The title of each section must make it clear what kinds of entries it contains, and all entries that fall within that subject area must be there. Also:

  • Use the same section names as similar dab pages, if practical. Consistency helps readers immensely.
  • Pick subject areas that don't overlap.
    E.g., vehicles and engines would fit in "Transportation" and in "Science and technology", so if you use both sections, readers won't know where to look. If overlap can't reasonably be avoided:
    • For one or two items that fit in multiple sections: duplicate these entries in each appropriate section.
    • For several items (or a subsection): put these entries in only one section, and put a hatnote at the top of any other appropriate sections, e.g.: {{for|<topic>|#<Section>}}.
  • Only combine closely related topics. Biology and medicine is fine; Cosmology and medicine is not. Other uses is the exception.
  • Avoid having lots of "other uses" entries – but not at the cost of making awkward or overly small sections (see § Moderate section size).
  • Separate fictional items from real ones.

2. Moderate section size[edit]

To minimize the reading users need to do on average, avoid both long, undivided sections, and lots of small sections:

  • Sections with more than ten to twelve entries should usually be divided into subsections, if practical. Use judgment based on the particular page.
  • Sections with one or two entries should often (for only one entry, almost always) be combined, typically in an "Other uses" section.

3. "Other uses" below[edit]

Entries that are not fully categorized belong in an "Other uses [in topic]" section at the end of the page or section (but before any "See also" section). The space above the first section on the page (or above the first subsection in a section) should not have any entries ("orphans"), except for:

And these entries should be repeated in the appropriate sections. "Loose" entries at the top of a page or section don't appear in the table of contents, and readers can easily miss them.

If all the "other" entries in a section can be described by a plural noun, the words "uses in" should be avoided, e.g.: Other people, not Other uses in people; Other media, not Other uses in media.

Also:[edit]

  • Use ==Wiki headings==, not bold text or semicolon markup, for headings (see WP:PSEUDOHEAD).
  • Put the table of contents before the first heading with {{TOC right}}.[note 1]
  • Use the "See also" section for entries whose titles are related to, but not strictly ambiguous with, the page title.
  • Order sections alphabetically unless there is a clear reason not to. (This is the easiest order to recognize – importance, for example, is usually too subjective.)

Schemes to avoid[edit]

Organizing schemes not based on subject area can be confusing. Avoid organizing entries by etymology, pronunciation, or whether the items are acronyms or not – these schemes assume knowledge that the reader may not have.

Certain variations on the ambiguous term may be used to sort entries within sections, such as:

  • Formatting, such as capitalization
  • Plural vs. singular forms of a term
  • The presence of "A", "An", or "The" (or their equivalent in a foreign language) at the start of a proper title

but these should not usually be the basis for section divisions, particularly when a subject area scheme can be used instead. For more on sorting within sections, see MOS:DABORDER.

Example scheme[edit]

This scheme, or any part of it, may be used to organize disambiguation pages. Braces ("{}") suggest alternative terms, which may be split up and recombined in keeping with the principles above. Common pitfalls that may make dab pages harder to navigate are marked in red.

NOTE! These headings are an example only; most disambiguation pages will only use a few of these headings. They should be liberally modified, supplemented, and promoted or demoted to different header levels to best suit each particular page. Disambiguation pages are enormously varied, and another scheme may better suit a given page.

Remember to remove visible braces ("{ }") and pipes ("|") before saving a dab page.

[Title] may refer to:

{Arts|Entertainment|Media}[edit]

[Avoid words like "(popular) culture" and "society"; they are too vague.]
[Sports-related entries are typically listed in "People", "Organizations", and/or "Sport", not here.]
[Technologies used for media and entertainment are typically listed in "Science and technology", not here.]
[If people or organizations in the arts are listed elsewhere, note this in a hatnote, e.g.: For people in arts and entertainment, see § People.]
[It may be helpful to separate items with proper names (e.g. The Noise (band)) from generic terms (e.g. noise music).]

Fictional {characters|elements}[edit]

[Useful for characters or elements that appear in multiple types of media; otherwise, sort by medium as follows.]

{Film|Radio|Television|Theater}[edit]

Gaming[edit]

{Literature|Writing}[edit]

[Avoid the word "Print", which excludes digital written media.]

{Books|Novels}[edit]

{Comics|Magazines|Newspapers|Periodicals}[edit]

{Short stories|Poems}[edit]

Music[edit]

{Artists|Bands|Performers}[edit]

{Albums|Symphonies|Extended compositions}[edit]

{Songs|Pieces|Tracks}[edit]

Other media[edit]

[Such as painting or sculpture]

{Businesses|Organizations}[edit]

[An "organization" is generally accepted to mean any group of people formally organized for a purpose. If "Organizations" is used, and businesses, schools, sports teams, etc. are listed elsewhere, hatnote(s) are needed here.]

{Government|Military|Political} organizations[edit]

[Break down geographically if needed]

{Schools|Universities}[edit]

[Break down geographically or by academic level if needed]

Sports {teams|organizations}[edit]

[If listed in a separate "Sport" section, note this in a hatnote]

Other {businesses|organizations}[edit]

[Break down by industry if needed]

{Economics|Finance|Law}[edit]

[For topics in economic science, a subsection of "Science" may be more appropriate.]

Language(s)[edit]

[Do not list dictionary definitions; these should be handled with the {{wiktionary}} template at the top of the page.]

Military[edit]

[Caution: This section may have significant overlap with "Organizations" and "Technology" sections; consider using them instead.]

People[edit]

[People with the page title as part of their common name should typically be listed on an anthroponymy page, such as Bob (given name), not a disambiguation page, unless there are only a small number of such people.]
[List groups of people (such as ethnic groups), names as such, and titles shared by several people separately from individuals.]

In {academia|science}[edit]

In {arts|entertainment|media}[edit]

[Break down by type of media if needed, but beware of overlap with an "Arts and media" section]

In business[edit]

In {government|military|politics}[edit]

In religion[edit]

Sportspeople[edit]

Other people[edit]

Places[edit]

[Break down geographically, or separate into buildings/facilities, populated areas (like cities and states), and natural formations, if needed]

{Religion|Mythology|Philosophy}[edit]

[If people in these fields are listed in a separate "People" section, note this in a hatnote.]

{Science|Technology|Mathematics}[edit]

[Avoid separating these topics, as they often have significant overlap.]
[If people in these fields are listed in a separate "People" section, note this in a hatnote.]

Mathematics[edit]

[Some consider mathematics to be a science, some don't. If there are math topics here, it is advisable to include "mathematics" in the parent section title.]

Natural sciences[edit]

{Astronomy|Cosmology}[edit]

{Physics|Chemistry}[edit]

{Geology|Earth science}[edit]

{Biology|Medicine|Biochemistry|Life sciences}[edit]

{Psychology|Sociology}[edit]

{Computing|Electronics|Telecommunication}[edit]

[Games and digital content belong under "Arts and media", not here, unless they deal with these topics specifically.]

{Military technology|Weapons}[edit]

[May overlap with "Electronics" or "Transportation" subsections.]

{Transportation|Vehicles}[edit]

[If transportation technologies are listed in a separate "Transportation" section, note this in a hatnote.]

Other uses in {science|technology|mathematics}[edit]

Sports[edit]

[Caution: This section may have significant overlap with "People" and "Organizations" sections; consider using them instead.]
[Break down by sport, geographically, or separate into amateur, professional, and school sports, if needed]

Transportation[edit]

[Caution: This section may have significant overlap with other sections as noted below. If used, handle as described in § Clearly defined subject areas.]

{Airports|Facilities|Stations}[edit]

[Overlaps with "Places".]

{Transit systems|Transportation companies}[edit]

[Overlaps with "Businesses and organizations".]

Vehicles[edit]

[May overlap with "Science and technology".]
[Often used for individual vessels (e.g. HMS Dreadnought (1906)), with types of vehicles (e.g. dreadnought) listed under "Science and technology" instead; if so, note this in a hatnote.]

{Aircraft|Spacecraft}[edit]

{Land vehicles|Cars|Rail vehicles|Trains}[edit]

{Maritime vessels|Ships}[edit]

Other uses[edit]

[Ambiguous entries that do not fit into another section. Entries that fit in another section, but not in any of its subsections, should be placed in an "Other uses in [topic]" subsection there.]

See also[edit]

[Entries that are similar or related to, but not ambiguous with, the page title, that might reasonably help readers find what they are looking for; see MOS:DABSEEALSO. Use judgment; do not include every page title that contains the ambiguous term.]

Notes[edit]

  1. ^ The {{TOC right}} template has no effect in the Vector 2022 skin, but affects users of older skins.

See also[edit]