Wikipedia:Manual of Style/Organizing disambiguation pages by subject area
This guideline is a part of the English Wikipedia's Manual of Style. It is a generally accepted standard that editors should attempt to follow, though occasional exceptions may apply. Any substantive edit to this page should reflect consensus. When in doubt, discuss first on the talk page. |
Manual of Style (MoS) |
---|
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:
- Identifying the relevant section from level 2 headers, then
- Identifying the relevant subsection (if present) from level 3 (and deeper) headers, then
- 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
edit1. Clearly defined subject areas
editThe 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:
- 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
editTo 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
editEntries 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:
- At most one primary topic, if there is one, at the top of the page; and
- A few significantly more common meanings, if they exist;
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
editOrganizing 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
editThis 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}
editGaming
edit{Literature|Writing}
edit- [Avoid the word "Print", which excludes digital written media.]
{Books|Novels}
edit{Comics|Magazines|Newspapers|Periodicals}
edit{Short stories|Poems}
editMusic
edit{Artists|Bands|Performers}
edit{Albums|Symphonies|Extended compositions}
edit{Songs|Pieces|Tracks}
editOther 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}
editIn {arts|entertainment|media}
edit- [Break down by type of media if needed, but beware of overlap with an "Arts and media" section]
In business
editIn {government|military|politics}
editIn religion
editSportspeople
editOther people
editPlaces
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}
editSports
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}
editOther 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- ^ In this diagram, the and symbols refer to the reader's interest, not "right" or "wrong".
- ^ The
{{TOC right}}
template has no effect in the Vector 2022 skin, but affects users of older skins.
See also
edit- Wikipedia:Long dab dos and don'ts, information page summarizing key points of this guideline