SmashWiki:Manual of Style

Shortcut:
SW:MoS
Guideline.png This page is a SmashWiki guideline, a principle that suggests how users should contribute and conduct themselves. When editing this page, please ensure that your revision reflects consensus. If in doubt, consider discussing changes on the talk page.

The SmashWiki Manual of Style is a style guide that aims to make the wiki easy to read, write, and understand.

Article titles

  • Titles should be singular, not plural.
    • Example: Item instead of Items
  • Titles should be nouns as opposed to verbs.
    • Example: Punishment instead of Punish
  • If a title is not a proper noun, only the first word should be capitalized. Sometimes there is disagreement over what is a proper noun; this should be discussed on the talk page.
    • Example: Back throw instead of Back Throw
  • Titles should conform to what is most commonly used and understood, not necessarily what is official. In other words, terms should be referred to as they make the most sense within the community (e.g. "tilt attacks" or "tilts" as opposed to "strong attacks").
    • Example: Tech instead of Ukemi, as while the latter is an official term, players universally use the former.
    • Example: Glancing blow instead of phantom hit, as while some players use the latter, the former is a widely recognized official term.
  • General character articles (those that focus on a character as they are outside of the Smash Bros. series) should be named according to how the character is most commonly known in their originating series. On the other hand, articles about playable characters' appearances in the Smash series should be named according to how the game names them.
    • Example: Fox McCloud instead of Fox
    • Example: Fox (SSBB) instead of Fox McCloud (SSBB).
    • Exception: Should a playable character be included in Smash that has the same in-game name as another character (and isn't an alternate costume), their fighter article can be named something else to differentiate the characters.
  • For tournaments, an article on the tournament series overall should end with (series). For example, an article on the tournament series "The Big House" belongs on Tournament:The Big House (series), while the article on the first tournament in the series, also called "The Big House," belongs on Tournament:The Big House.

Sections/headings

Levels

  • Most sections should be level two headings; that is, they are formatted with two equals signs. Subsections should be one level higher than the section it is contained in.
    • ==Heading==
    • ===Subsection===

Wording

  • Like article titles, headings should only be capitalized if they are proper nouns.
    • Example: List of characters instead of List of Characters
  • Headings should be kept short, and should not include colons (:).

Text

  • Long stretches of text should be broken into paragraphs. For very long strings of text, consider breaking the paragraphs into subsections.
  • Disambiguation pages should be ordered in terms of relevancy (such as playable characters being prioritized over other entities with similar-sounding names/handles. An example: Cloud Strife being prioritized over Cloud9).

Formatting

  • The subject of an article should be highlighted in bold text in the first sentence of the article. Bold text should generally be avoided otherwise.
  • Names of games and other works should generally be displayed in italics.
  • Other forms of text decoration (such as underlines) should be avoided.
  • Coloured text is discouraged.

Writing style

  • Do not make edits by copying text directly from other sources. This is plagiarism, which hurts the credibility of both us and the source. Edits should not appear as if someone other than the editor wrote them.
  • Style of writing should be semiformal, with no silly remarks or slang.
  • Initials and abbreviations should not be used instead of the proper name within articles. A shortened name can be acceptable, however, if the full name was already used in the article or section. For the original Super Smash Bros., SSB, SSB64, and Smash 64 are all acceptable shortened names. When referring to Super Smash for Wii U and Nintendo 3DS collectively, SSB4 and Smash 4 are acceptable abbreviations.
    • Example: "MK is the best character in SSBB" is never proper.
    • Example: "Meta Knight is the best character in Brawl" is proper, if the full title Super Smash Bros. Brawl was already used in the article.
    • Exception: Competitive terms that are commonly used and known by their initials, such as "DI" instead of "directional influence", can have their initials used in articles instead of the full name.
  • Language should be gender-neutral, unless referencing a specific character or person.
    • All Pokémon should be treated as gender-neutral, even in the case where their gender is clear (e.g. Pikachu's last two alternate costumes in Super Smash Bros. Ultimate or Spiky-eared Pichu, who are both female in Pokémon itself).
    • Some fighters have no defined gender in their home series and change gender in some of their alternate costumes in Smash Bros. (such as Robin and Inkling). When discussing these characters in the context of their home series, it is acceptable to refer to them with gender-neutral language. When discussing these characters as Smash Bros. fighters, it is preferred to use the gender of the default costume. In either case, omitting pronouns entirely is a valid style as long as the text does not become unnecessarily clunky.
  • When referring to the individual Ice Climbers, always use Popo to refer to the player-controlled leader, and Nana for the computer-controlled partner. While some alternate costumes have Nana as the leader and Popo as the partner, Popo as the leader and Nana as the partner is the default configuration in-game, and in the competitive community, the leader is referred to as Popo with the partner being called Nana regardless of the costume. Additionally, "Popo" and "Nana" are easier to use and flow better in articles than "leader climber", "partner climber", and the like.
  • All writing should be done in third person.
    • Example: the player must instead of you must
    • Example: The glitch can be done by... instead of You can do the glitch by...
  • There is no preference whether to use American or non-American English; therefore, one should not make an edit to a page that consists of only changing such spelling/grammar. However, it is preferred to remain consistent within a section or article. Relatedly, articles on localized subjects, such as American tournaments or British players, should use the same regionalization as their subjects.
    • Example: The following are all spelled correctly: canceled, cancelled, realize, realise, center, centre, color, colour
    • Example: Putting trailing punctuation inside or outside quotation marks is okay.
    • Exception: Double quotes must be used, as single quotes are used for formatting.
    • Exception: Technical syntax may require a specific form of "color" or "colour".
  • Likewise, when multiple acceptable variants of a word exist (regardless of region), there is no reason to change the word written on a page into another variant of it.
    • Example: The following are both spelled correctly: Samus', Samus's
  • When referring to differences in games based on geographical region, "NTSC" is used for the Americas and Japan region and "PAL" is used for the Europe and Australia region. While this terminology may be antiquated, its meaning is generally understood, and it is much shorter and cleaner than alternatives.
  • As the Smash Bros. series was developed in Japan, all its underlying data is coded in metric units. Therefore, when referring to in-game measurements, always use metric first, followed by an imperial measurement if necessary.
    • Example: "Hit Sandbag 1000 m (3280 ft.) or more in Home-Run Contest."
    • Exception: If a trophy description is different between NTSC and PAL regions (and the measurement units are not the only difference), use only whatever units are appropriate.
  • Unnecessary hyphens should not be used; if a combination of two words is proper without use of a hyphen, or are proper without being connected, a hyphen should not be used.
    • Example: Use followup instead of follow-up.
    • Example: Use up tilt instead of up-tilt.
    • Example: Use bair instead of b-air.
      • Note: Some terms such as fair can be confusing to some readers when shortened like this. If in doubt, use a spelled-out version such as forward aerial.
  • Spell-checking systems may not recognize terms as valid words (e.g. they might suggest replacing "edgeguard" with "edge guard"). Do not automatically follow their suggestions.
  • In general, using emphasis should be avoided in articles. In cases where emphasis cannot be avoided, either bold text or italic text is acceptable, and should not be intermixed.

Spacing

  • Generally, spacing does not matter to readers of an article (the software removes most extra spacing); however, it can have a large impact on the readability of the code when one is trying to edit the page. The code should have enough spacing to make the coding clear while not taking up too much room.
    • Example: It does not matter whether one uses one space or two spaces between sentences, as both are reduced to one space.
    • Example: Leaving a blank space between an article and its categories makes it easier to recognize the two.
    • Exception: If there is not at least one blank line between two paragraphs, they will be treated as one single paragraph.
    • Exception: More than two consecutive blank lines may leave a proportionally sized blank space on the page.
    • Exception: Complex tables and templates can be very picky at times when it comes to spaces and returns. Be mindful and always preview edits of such pages.

Images

  • Images should be right-aligned if possible.
  • Large images should be displayed as thumbnails, without a specified size.
  • If an article has a lot of images, most of the images should be displayed in a gallery. Galleries should be listed under a level two heading (==Gallery==).

Captions

  • Images that are not part of an infobox should be given a caption relevant to the article.
  • Captions should generally end with a period.
  • Captions should generally avoid any formatting other than links and necessary italicization (such as game titles).

Uploading images

  • Avoid uploading duplicate images. If the intent is to replace an existing image, discuss the change first, then upload the new image on top of the old one (if possible).
  • Images should be named descriptively. A name such as "00293347.jpg" is not useful and may lead to the image being either moved or deleted.

Internal links

  • Generally, only link to an article once. If "damage" is mentioned five times on a page, it should only link to [[damage]] the first time. The exception is if the page is very long, in which case it can be linked again near the start of a later section. If helpful to readers, links may be repeated in infoboxes, tables, images, image captions, and footnotes.
  • Use efficient links, especially for plurals and verb forms.
    • There are many different templates that can be used to allow links to be shortened so they avoid taking up too much space, including: {{SSB}}, {{SSBM}}, {{SSBB}}, {{SSB4}}, {{SSBU}}, {{s}}, {{b}}, {{Sm}}, and {{t}}.
    • Example: [[grab]]s instead of [[grab|grabs]]
  • Similarly to the above, linking to a redirect that is an abbreviation or a redirect that links to a section of another page is acceptable (and often preferred), unless an abbreviation isn't appropriate in the context.
    • Example: Using [[SSBB]] or [[Brawl]] is fine in most cases (often table headings and infoboxes), whereas [[Super Smash Bros. Brawl]] should be used the first time it's mentioned on the page, and [[Super Smash Bros. Brawl|Brawl]] is never necessary and should be avoided
    • Example: Using [[PK Thunder#PK Thunder 2|PK Thunder 2]] is an unnecessary waste of code compared to [[PK Thunder 2]]
  • The capitalization of the first letter of the link does not matter, but the capitalization of the other letters does. This means that single-word links can be written for whatever capitalization is needed in the sentence, while links of two words or more cannot.
    • Example: [[shield]] and [[Shield]] are equivalent
    • Example: [[shield grab]] and [[Shield grab]] are equivalent, but [[Shield Grab]] is not
  • When displaying an image, [[Image:]] and [[File:]] have the same function. Like American vs. non-American spellings, both are equally acceptable, and making an edit simply to change this is highly discouraged.
  • When placing links over text, it is recommended to only use 1 to 5 words for that link. A link should not use more than 10 words, except in very special circumstances. Turning entire sentences into links is also highly discouraged.

Tournament pages

  • Results on a tournament page should be ordered as such:
    • Main events first, then side events.
    • Games should be ordered by release date. Non-Smash Bros. events and modded games go at the end.
    • Singles should be placed before doubles.
  • The amount of placings expected to be documented within any bracket on a tournament page will vary depending on the size and skill depth of the tournament. There are no hard rules to this, but generally, any local level event should have at least the top 8 listed, a smaller regional should have at least the top 16 listed, a larger regional should have at least the top 32 listed, a superregional should have at least the top 48 listed, a major should have at least the top 64 listed, and a supermajor should have at least the top 96 or even top 128 listed. Any tournament with too few results reported for its level should be tagged with {{results}}.
    • On another note, there is no such thing as "too much results" on any tournament page, SmashWiki does not have a limit to how deeply a tournament's results can be documented on the wiki. In fact, the wiki should ideally have the complete results documented, as the online source for the tournament's results may not always be available in the future if a reader wants to see more of the results than what SmashWiki documents (as the many Brawl tournaments whose results were permanently lost when AllisBrawl went down can attest to). SmashWiki just does not expect any editor to extensively document results beyond a high enough cutoff, given the increasingly high amount of effort it requires to write down results with each additional placing, which would become monumental with some of the biggest supermajors that have had thousands of entrants. If an editor does want to document especially deeply into a tournament's results or even the entire tournament, the only caveat is that they should stop automatically linking players who do not have an article and will likely not merit an article in the near future, so as to not fill wanted pages with players who should not have Smasher articles. Additionally, if a tournament's results table were to get excessively large, its complete results table should be placed on a subpage, while the main page has a table with the top 64 or so listed.
  • When reporting which characters a player used in a tournament, it is standard to not list every character the player chose over the tournament, but only list characters that were used to win a game in a won set, so as to not mislead which characters were actually responsible for the player's placing. Additionally, characters used by high-placing players in early pool matches should generally be ignored, as the massive skill gaps that often occur in these matches mean top and even high level players will typically win these matches regardless of their effort, and so a character they may have sandbagged with in these matches does not truly reflect the characters that legitimately contributed to their final placing.
  • When listing a flag next to a player, it should not be strictly based on their birth country nor where they have official citizenship, but rather their country of permanent residence at the time the tournament took place. For example, ZeRo is from Chile, but immigrated to the United States by the end of 2013, so all tournament results from before 2014 should have him listed with the Chilean flag, but all tournaments after that point should use the American flag for him in their results instead. In a more extreme example, Hungrybox was born in Argentina, but has resided in the United States for most of his life, including for his entire Smash career, and thus all of his results on the wiki should have him listed with the American flag rather than the Argentine flag, despite him not becoming an American citizen until 2017.
    • Conversely, if a player is only living in another country on a short term temporary basis, such as on a visitor visa or for a short university stint, their flag should not be changed.
    • In cases of long term dual-residencies, such as when a player is living in another country to attend higher education, the flags from both their countries of residence should be listed.
  • When ordering players who are tied, it does not matter how they are ordered, but for ease of reference with the tournament source, it should be as given in the tournament's official results page.

See also

Words to Watch