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

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.[a]

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 aren't accounted for in the table of contents, so readers relying on the ToC 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}}.[b]
  • 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 terms 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(n)" or "The" (or their equivalent in another 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 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. ^ In this diagram, the  Y and  N symbols refer to the reader's interest, not "right" or "wrong".
  2. ^ The {{TOC right}} template has no effect in the Vector 2022 skin, but affects users of older skins.

See also

edit