BattleTechWiki:Manual of Style/Disambiguation
Sarna News
 |
| Manual of Style (MoS) |
|---|
Disambiguation pages are non-article pages designed to help a reader find the right BattleTechWiki article when different topics could be referred to by the same search term, as described in the guidelines on the Guideline:Disambiguation page. In other words, disambiguation pages help readers find the specific article they want when there is topic ambiguity.
Contents
Purpose[edit]
The style guidelines on this page aim to give disambiguation pages a consistent appearance and help the efficiency of searches by excluding extraneous information. Any page containing one of the disambiguation templates should contain only disambiguation content, whether or not the page title contains "(disambiguation)."
Users interested in learning more about wiki formatting (that which is required for this topic) will find detailed instructions on this page. Those wanting just a brief summary of main points can skip to the § Checklist at the bottom.
When disambiguation is not needed[edit]
There are occasions in BattleTechWiki when there are multiple pages relating to the same subject. {{Phoenix Hawk}}, for example, also has separate pages for the {{Phoenix Hawk IIC}}, {{Phoenix Hawk L}}, and {{Phoenix Hawk LAM}} models. These BattleMech variations are already linked to each other in a section on each of their respective pages, and as there are no other articles with the same term, a disambiguation page is not needed. Simply put, a disambiguation page is needed for "different things called" rather than "different versions of the thing called."
Additionally, a disambiguation page with only two meanings is not necessary if one of them is the primary topic for that term. The recommended practice in these situations is to place a hatnote on the primary topic article to link directly to the secondary topic. The {{for}} and {{redirect}} templates are useful. If neither of the two meanings is primary, then a normal disambiguation page is still used at the base name.
Page naming[edit]
In general, the title of a disambiguation page is the ambiguous term itself, provided there is no primary topic for that term. If there is already a primary topic, the "(disambiguation)" qualifier should be added to the title of the disambiguation page, such as {{Falcon (disambiguation)}}.
There will be times when an article is currently occupying the primary topic spot but might not be relatively significant compared to other similar terms. These pages can be moved to make way for a disambiguation page if approval is directly or tacitly given. Generally, planetary systems and iconic BattleMechs tend to be the most interlinked and searched terms and warrant being the primary topic, while individual ships, single-named characters, and planetary locations are not and can more easily be moved. While this is not the only indicator, viewing the "What links here" link in the toolbox can provide a sense for how much a page is used.
Introductory line[edit]
The term being disambiguated should be in bold, not in quotes or italicized. It should begin a sentence fragment ending with a colon, introducing a bulleted list:
Blackjack may refer to:
Hidden War(s) may refer to:
Individual entries[edit]
After the introductory line comes a list of individual entries—lines which direct the readers to BattleTechWiki articles on the various topics being referenced by the term being disambiguated. Keep in mind that the primary purpose of the disambiguation page is to help people find the specific article they want quickly and easily. For example:
Guardian may refer to:
- Guardian (BattleMech), the 15-ton ultralight BattleMech
- Guardian (Conventional Fighter), the close air support fighter
Apply the following rules when constructing entries:
- Preface each entry with a bullet (an asterisk in wiki markup).
- The link should come at the start of the entry.
- The article title should appear exactly as it is on the target page; the link should not be piped except under certain circumstances (see § Italics (Piping)).
- Start each entry with a capital letter, unless it begins with a link to an article with a lowercase title, like {{ilClan}}.
- Insert a comma after an entry when a description is included. In some cases, especially with military commands, the title of the article alone is sufficient and no description is necessary.
- For the description, use a sentence fragment with no closing punctuation.
- Keep the description associated with a link to a minimum, just sufficient to allow the reader to find the correct link among the entries.
- Avoid descriptions that simply repeat information given in the link, for example:
- Damocles (moon), a moon
However, this information may be repeated as part of a fuller description, if it adds value for the reader:
- Damocles (moon), one of Addicks IV's four moons
- Do not emphasize links with bolding or italics unless required to conform to standard writing conventions or BattleTechWiki's Manual of Style. In general, if the linked article applies italics to the ambiguous term, duplicate it on the disambiguation page's entry. If the article's title contains a clarifier, such as {{Spirit (BattleMech)}}, then italicize only the title by piping the link.
- In some cases, the target article title does not contain the term being disambiguated. For example, the link in the below entry is to the Fourth Skye Rangers military command, since a redirect page for their nickname would be to the same location:
Albion may refer to:
- The nickname of the Fourth Skye Rangers
Links[edit]
- A disambiguation page should have at least two blue links on the page, because the purpose of disambiguation is to direct users to other BattleTechWiki pages.
- Never include external links either as entries or in descriptions. These pages disambiguate BattleTechWiki articles, not the World-Wide Web. In rare cases such as {{Götterdämmerung}}, important editorial notes might include external links to clarify the term's usage in BattleTechWiki.
- References should not appear on disambiguation pages, as they are portals, not articles.
- To efficiently guide readers to the most relevant article for that use of the ambiguous term, avoid using links in the description.
- Deimos (Individual Union-class DropShip), a Gray Death Legion mercenary DropShip
But not:
- If deemed helpful for navigation or context, especially for literature or in cases where a description is relatively generic, one link may be added. Common words such as BattleMech, MechWarrior, DropShip, any of the Great Houses or ranks, etc., should never be made a link.
- Paladin (short story), a BattleCorps short story by Jason Schmetzer
- Brin (Clan Jade Falcon), a MechWarrior from the Fifth Battle Cluster
Entries that should not be created[edit]
- An entry without a blue link is useless for further navigation. (See § Red links for cases in which no article yet exists.)
- Do not include entries for topics that do not use the term being disambiguated.
- Do not create entries merely because the term is part of the name.
Black may refer to:
- Black Knight, the 75-ton BattleMech
- Case BLACK, a Taurian strategy during the Reunification War
- Only create entries for topics that have dedicated content in articles; do not create entries for related topics that might not directly address the sought-after information.
Terms that contain additional words[edit]
Entries do not have to be limited to the exact spelling of the term shown in the disambiguation page title, so long as they are strongly associated with the term. Often, a given term is not the first word of the article or contains additional words afterward.
Protector may refer to:
- Protector of the Realm, the ruler of the Taurian Concordat
- The Protector, Clan Cloud Cobra destroyer
Hephaestus may refer to:
- Hephaestus Station, a customized modular space station operated by Wolf's Dragoons, also known as Hephaestus
- The ARS-V1D Hephaestus configuration of the Ares OmniMech
Padilla may refer to:
- Padilla Heavy Artillery Tank, the Star League-era tank
- Padilla Tube Artillery Tank, the Republic-era tank
- House Padilla, a mercenary martial family
There are many cases in BattleTechWiki where articles, especially with Vehicles, have its extended name written out instead of using just its primary name. In the {{Padilla}} example, it would be confusing and difficult to distinguish between the two tanks if shorter terms had been used, but in context they are both referred to simply as "Padilla," and so a disambiguation page is not only appropriate but necessary.
Acronyms and abbreviations[edit]
Common abbreviations of terms may be considered terms themselves in regards to disambiguation. If there is uncertainty about whether a situation applies, it is often best to assume that it does.
TAG may refer to:
- Target Acquisition Gear, a component for artillery spotters
- Tharkad Aerospace Group, a Lyran weapons manufacturer
Nova may refer to:
- Nova Combined Electronic Warfare System, also known as the Nova CEWS
- Sunbeam Mark XXI Nova Laser Pistol, also known simply as a "Nova"
Given names or surnames[edit]
Generally, characters identified only by a single name (given or surname) are treated the same as any other term in regards to disambiguation. The {{Karen}} page has been set up as an exception, but in this example, every entry of Karen containing a surname should normally not be listed.
Multiple characters having the same given and surname require disambiguation; in this case, the term is the full name. For example: {{Terrence Marik}}.
Exceptions might be possible in cases where a disambiguation page already exists for reasons consistent with previously mentioned guidelines. The {{Kerensky}} page, for example, lists appropriate entries at the top, but is then followed by a section for notable characters featuring the Kerensky surname, as some of the people listed are very well established in BattleTech lore.
Misspellings[edit]
Common misspellings should be listed only if there is a genuine risk of confusion or misspelling. These cross-links should be placed in a separate section entitled as seen below:
In this example, a link to {{Torrence}} is present because the planetary system had been misspelled frequently in a major publication. The inclusion of a misspelling section should be used sparingly and left out when when usure about its necessity. There are many instances where changing or adding one letter within a term leads to an entirely different term, such as between {{Andrew}} and {{Andrews}}. This is an unavoidable part of BattleTechWiki.
Plurals and suffixes[edit]
A distinction is made between terms that have different meanings owing to slight spelling differences, and those that for all intents and purposes are the same, but may not be written exactly identical. Such articles may have initials in the name, be the plural of the disambiguation term, or contain a suffix in the form of Roman numerals or "Jr." All these variations may be considered appropriate as entries.
Rough Rider may refer to:
- Rough Rider (Individual WarShip), Nicholas Kerensky's flagship
- Rough Riders, the Taurian Concordat holovid series
But not:
Sam Lewis may refer to:
- Sam Lewis (person), a BattleTech Line Developer during the FASA era
- Sam Lewis (Scientist), a Federated Suns Professor-General
- Samuel Lewis (Businessman), the founder of S. L. Lewis Incorporated
- Samuel Lewis, Jr., the son of Samuel Lewis
Italics (Piping)[edit]
Piping is a mechanism that conceals the title of a linked article by replacing it with other text. For example, instead of showing the full title {{Apollo (system)}}, it may be presented as [[Apollo (system)|Apollo]], resulting in the link {{Apollo}}.
Apart from exceptions mentioned on this page, piping should generally not be used on disambiguation pages. This is to make it clear to the reader which topic is the subject of an article title. For example, on the disambiguation page {{Apollo}}, in the entry {{Apollo (system)}}, the parenthetical "(system)" should be visible so that the reader sees which "Apollo" topic the entry is about, among others sharing the same base title. In many cases, what would be hidden by a pipe is exactly what the user would need in order to find their intended article.
Piping is necessary on disambiguation pages primarily when words within a title are italicized in order to conform to standard writing conventions or BattleTechWiki's Manual of Style. All space-faring ships, 'Mechs, and book/story titles are italicized, as well as non-standard ranks and Clan terms (See Policy:Italics).
- Centurion (Aerospace Fighter class), the first fighter developed by the Federated Suns
- Centurion (rank), the Marian Hegemony Armed Forces equivalent of a lieutenant
- Hel (BattleMech), the 50-ton BattleMech later renamed the Eris
- Hel (Loki Mk II), the 65-ton Clan OmniMech
The words in the parenthetical clarifiers are usually not italicized, as they are present only for purposes of disambiguation and aren't officially part of the term. When editing, the article title is duplicated with a vertical bar (|) inserted in between. Now, the text on the right side (what is seen to readers) can have italics applied to the target word with two single quotes ('') on each end. The text on the left side of the bar is the link address, which remains unchanged.
* [[Hel (BattleMech)|''Hel'' (BattleMech)]], the 50-ton BattleMech later renamed the ''Eris''
* ''[[Hel (Loki Mk II)]]'', the 65-ton Clan OmniMech
While the vast majority of the parentheticals used in BattleTechWiki page titles function as disambiguation clarifiers, there are a handful of BattleMech pages where the parenthesis is used to provide an alternate name, such as {{Timber Wolf (Mad Cat)}}. For these specific examples, the entry is not piped and will simply have the italics around the entire title, as seen above.
Items appearing within other articles[edit]
If a topic does not have an article of its own, but is discussed within another article, then a link to that article may be included if it would provide value to the reader. Such entries may be notable for purposes of inclusion in a disambiguation page. Whether or not the link is at the start the line, it should still be the only one. For example:
Fox may refer to:
- Hanse Davion, who was nicknamed "The Fox"
Columbia may refer to:
- Columbia (continent), one of Rocky II's five continents
- Columbia (moon), Kentares IV's only moon
- Columbia, a location on Mitchella II
- Columbia Isles, a location on Shiro III
It is often useful to link to the relevant section of the target page and conceal that by making it a piped link. In the {{Columbia}} example, the continent and moon have dedicated redirect pages, but the two city locations do not. When editing, this is how they are piped:
* [[Mitchella#Planetary Locations|Columbia]], a location on Mitchella II
* [[Shiro (system)#Planetary Locations|Columbia Isles]], a location on Shiro III
Owing to the ever-expanding nature of BattleTechWiki, there will be instances when the structure is not entirely in place to support new categories. In this case, the lack of style and formatting guidelines for places and locations requires piping to the Planetary Locations section of system articles. This should be sufficient for navigation at this time.
Red links[edit]
A link to a non-existent article, a "red link," should be included on a disambiguation page if it serves as a placeholder for an term that hasn't been written about yet but is judged appropriate for a future article. Do not create red links to articles that are unlikely ever to be written, or are likely to be removed as insufficiently notable topics. If the red link is already present in other articles, it should be written the same way on all pages.
When adding the red link into the disambiguation page, it is formatted the same as any other normal, blue link entry.
- John (Individual Union-class DropShip)
- John (Individual Union-class DropShip), Smith's Legion mercenary DropShip
Organization[edit]
Ordering[edit]
The following guidelines describe the appropriate order of entries on disambiguation pages:
- The primary topic, if there is one, should be placed at the top.
- Entries using only the disambiguated term and its parenthetical qualifier, in alphabetical order.
- Entries starting with the term but containing additional words, in alphabetical order.
- Entries containing the term but starting with a different word, in alphabetical order.
- Entries for terms that currently don't have their own redirects, due to pending structural changes in BattleTechWiki. (For example: {{Unity City}})
- Entries not beginning with a link or where the term is not used.
Scout may refer to:
- Scout (Individual Invader-class JumpShip), Clan Wolf JumpShip
- Scout (unit role), the battlefield role performed by certain BattleMechs and ground vehicles
- Scout Infantry, covert agents specializing in infiltration and espionage
- Bright Star Auto Scout, the (failed) robotic scout JumpShip design
- Gray Death Scout, the battle armor design
If an entry is directly related to another, it's appropriate to have it indented and immediately follow the original entry. This provides clarity that the articles are connected.
- Arrow IV Artillery, the stand-alone, missile-based artillery system
- Arrow IV Homing Missile, a more accurate variation of the Arrow IV missiles
- New Syrtis (WarShip class), Federated Suns carrier
- New Syrtis (Individual New Syrtis-class WarShip), first ship in the aforementioned class
Grouping by subject[edit]
A large number of entries can make it difficult for a reader to find a particular topic. On longer disambiguation pages, a subject section may be helpful if several entries belong to a shared category. These sections should typically be in alphabetical order.
Dash may refer to:
- Dash (7th Falcon Regulars), a Clan Jade Falcon MechWarrior
- Dash (305th Assault), a Clan Jade Falcon MechWarrior
- Dash (Turkina Keshik), a Clan Jade Falcon MechWarrior
Communications Systems:
Small sections of less than three entries may impede navigation and should be avoided. If most or all of the entries on a disambiguation page belong to a single category—for example, {{Dena}} is filled with only character entries—a section should not be used.
Section titles can be chosen on a case-by-case basis and may include (examples in parenthesis):
- BattleTech Trading Card Game {{Firestarter}}
- Code names {{Damocles}}
- Common misspellings {{Quarrel}}
- Communications systems {{Maxell}}
- Components {{Thunderbolt (disambiguation)}}
- Literature/Products {{Succession Wars}}
- Military commands {{Marauder (disambiguation)}}
- Planetary locations {{Hamilton}}
- Vehicles {{Scout}}
Images and templates[edit]
Images, icons, InfoBoxes, and transcluding templates, etc, should not be used.
Tags and categorization[edit]
At the bottom of the page, the {{disambig}} template should be used identifying the page as a disambiguation page. This produces a general disambiguation notice and places the page in Category:Disambiguation.
If a disambiguation page needs cleaning up to bring it into conformance with this style manual, use {{disambiguation cleanup}}. This replaces both {{disambig}} and {{cleanup}}.
Disambiguation pages do not need to be placed into any categories other than those generated by the template. If new topical categories of disambiguation pages seem to be needed, please bring this up for discussion at Policy talk:Disambiguation.
Checklist[edit]
|
|