User:Toomai/MoS Rewrite

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
• 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 should be named according to how the game names them.
  • Example: Fox McCloud instead of Fox
  • Example: Fox (SSBB) instead of Fox McCloud (SSBB)

Sections/headings

Levels

• Most sections should be level two headings; that is, they are formatted with two equals signs. A subsection is one level higher than the section it is contained in.
  • Example: The title of this section is formatted as ==Sections/headings==. The subsection is formatted as ===Levels===.

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.

Text

• Long stretches of text should be broken into paragraphs. For very long strings of text, consider breaking the paragraphs into subsections.
  • Example: See the Subspace Emissary plot summary.

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.
• Coloured text is discouraged.

Writing style

• Style of writing should be semi-formal, with no silly remarks or slang.
• Language should be gender-neutral, unless referencing a specific character or person.
• All Pokémon should be treated as gender-neutral.
• All writing should be done in the third person.
  • Example: the player must instead of you must

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: Leaving a blank space between an article and its categories makes it easier to recognize the two.
• The exception to the above is space between paragraphs. If there is not at least one blank line between two paragraphs, they will be treated as one single paragraph.

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 end with a period if and only if they are a complete sentence.
• Captions should generally avoid any formatting, though they may have links.

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 new one.
• Images should be named descriptively. A name such as "00293347.jpg" is not useful and will 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.
• Use efficient links, especially for plurals and verb forms.
  • Example: [[grab]]s instead of [[grab|grabs]]
• Similarly to the above, linking to a redirect that is an abbreviation is acceptable (and often preferred), unless an abbreviation isn't appropriate in the context.
  • Example: Using [[SSBB]] 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|SSBB]] is never necessary and should be avoided
• 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, both [[Image:]] and [[File:]] are acceptable.