The Deadlock Wiki

Editing Deadlock:Style guide

Warning: You are not logged in. Once you make an edit, a temporary account will be created for you. Learn more. Log in or create an account to continue receiving notifications after this account expires, and to access other features.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
This '''style guide''' is a guideline for writing articles and related content on the wiki. It establishes our in-house style, so editors can write content with consistent, clear, and precise language, layout, and formatting. If everyone follows the same conventions, it makes reading and navigating easier for readers, and editing and coordinating easier for editors. Reading this style guide helps keep edits consistent across the wiki.
This '''style guide''' will serve as a guideline for writing articles and related content on the Deadlock Wiki. It establishes our in-house style, to help editors produce content that follows a consistent, clear, and precise language, layout, and formatting manner. If everyone follows standardized conventions, it will make reading and navigating easier for readers, and editing and coordinating easier for editors. Reading this style guide is important to preserve consistency among edits.


A more expansive set of guidelines can be found on [[wikipedia:Wikipedia:Manual of Style|Wikipedia:Manual of Style]].
A more expansive set of guidelines can be found on Wikipedia at the [[wikipedia:Wikipedia:Manual of Style|Manual of Style]].


== Structure ==
 
=== Article pages ===
==Articles==
Different pages will not have the same information, but there is a general structure for every article. Sections should always appear in this order:
===Structure===
# Notice: This includes {{t|Cleanup}}, {{t|Construction}}, and {{t|Outdated}} templates.
Different pages with different sections will not have the same information, but there is a general structure for every article. The follow sections should always be shown in this order:
# Disambiguation
# Notice: This includes {{t|cleanup}}, {{t|construction}}, and {{t|outdated}} templates.
# Disambiguation:
# Infobox: Corresponding information is displayed here.
# Infobox: Corresponding information is displayed here.
# Introduction: A brief overview of the article, optionally including the patch it was introduced in.
# Introduction: This covers a brief overview of the article. It can also include the patch it was introduced in.
# TOC: Appears automatically before the first section on most articles.
# TOC: On most articles, the TOC will automatically appear before the first section.
# Main Page: The main information of the article, covered in further depth.
# Main Page: This covers the main information of the article or goes in further depth.  
## Heroes, Items, Units, and Update history have varying section orders, but they should each be internally consistent.
## Heroes, Items, Units, and Update History have varying section orders, but they should all be consistent.
# Version History: If content has changed over the course of the game, that information is listed here.
# Background: For Hero pages, this is the hero's in-game background. For non-Hero characters, this can be renamed "Lore" (see below).
# Background: For Hero pages, this is the hero's in-game background. For non-Hero characters, this can be renamed "Lore" (see below).
## Lore: Subsection of Background, listing extra information about the character and their backstory from other official sources (voice lines, visual novels, etc.).
## Lore: Subsection of Background, lists extra information about the character and their backstory from other official sources (voice lines, visual novels etc.)
# Character interactions: For Hero pages, relevant information from voice lines related to other heroes.
# Character interactions: For Hero pages, lists relevant information from voice lines related to other heroes.
# Update history: Any content that has changed over the course of the game.
# Gallery: The gallery shows images otherwise too bulky to fit into the main article.
# Gallery: Images too bulky to fit into the main article.
# Trivia: This covers tidbits of information not appropriate for the main page, or make references to content outside of the game. (Whether a lore-related information should go on "Trivia" or "Lore" or "Character interactions" is based on relevancy)
# Trivia: Tidbits not appropriate for the main page, or references to content outside the game (see "Trivia" below).
# Navigation: Navigation templates go at the end of the article.
# Navigation: Navigation templates go at the end of the article.


=== Voice line pages ===
===Quote Page - Structure===
For voice line pages, sections should always appear in this order:
For Hero quote pages, the following sections should always be shown in this order:
# Select
# Select
# Unselect
# Unselect
# Conversations: Match start conversations between Heroes.
# Ability voice lines
# Ability voice lines: One sub-section per ability, named after the ability (e.g. Abrams' Ability 1, "Siphon Life"). Voice lines such as upgrade_power and use_power go here.
## Ability 1: The name of the sub-section should match the abilities name, for example, Abrams' Ability 1 would be called "Siphon Life." Voice lines such as use_power and use_power go here.
## Ability 2: For example "Shoulder Charge."
## Ability 3: For example "Infernal Resilience."
## Ability 4: For example "Seismic Impact."
# Generic voice lines
# Generic voice lines
## Generic kill voice lines: Unspecific voice lines triggered by a kill, such as kill_anyhero and kill_high_networth.
## Generic kill voice lines: Unspecific voice lines, which are triggered by a kill, such as kill_anyhero, kill_high_networth and similar voice lines.  
## Item use voice lines
## Item use voice lines
## Gameplay voice lines: Contextual voice lines, such as shop_reminder and tower_denied.
## Gameplay voice lines: Contextual voice lines, such as shop_reminder, tower_denied and similar voice lines.  
# Hero-specific voice lines
# Hero-specific voice lines
## Enemies: Lines referring to a Hero on the opposite team, such as pings and kill_hero.
## Enemies: Any lines referring to another Hero on the opposite team, such as pings, kill_hero and similar voice lines.
## Allies: Lines referring to a Hero on the player's team, such as pings and killed_in_lane.
## Allies: Any lines referring to another Hero of the players team, such as pings, killed_in_lane and similar voice lines.
# Conversations: Match start conversation between Heroes are listed here.
# Other characters: Voice lines of other characters referring to the Hero, such as Patron match_start voice lines.
# Other characters: Voice lines of other characters referring to the Hero, such as Patron match_start voice lines.
# Removed and unused voice lines
# Removed and unused voice lines
# Other voice lines: Anything that doesn't fit the above sections.
# Other voice lines: All voice lines that do not fit the above sections in any way.
 
==Spelling==
American spelling, grammar, and sentence structure is used on the wiki and any templates involved. There is one exception:
*If quoting a source, never alter any part of the quotation, even if it does not use American spelling or contains spelling errors.  


== Writing style ==
=== Capitalization ===
* American spelling, grammar, and sentence structure are used on the wiki and any templates involved, with one exception: if quoting a source, never alter the quotation, even if it does not use American spelling or contains errors.
Capitalization should be reserved for proper names only.
* Capitalization is reserved for proper names: heroes, items, abilities, units, locations, anything Valve capitalizes regularly, and quoted content.
All heroes, items, abilities, monsters, and locations are always capitalized, along with any content that Valve capitalizes regularly, or quoted content.
* Use commas to structure large numbers.
* All sections should follow the same tense.
* All articles are written in third person; never use "you" when referring to the reader.
* Never use contracted forms.
* Formal language is mandatory on all wiki pages.
* Don't instruct readers directly or presume their prior knowledge. Avoid injecting point of view or subjective perspective.
* Strategy sections may take some liberties with recommendations, but should explain why an outcome may or may not work.
* Quotes spoken by characters may be used outside of their original context as long as they fit the article. For example, {{HeroIcon|Mirage}}'s voice line for his {{AbilityIcon|Fire Scarabs}} ability is used to describe {{PageRef|Trooper|alt_name=Troopers}}.
* Quotes placed on top of Hero pages should hint at that hero's gameplay. For example, {{HeroIcon|Seven}}'s {{Tooltip|quotation|The masses will fall!}} suggests that his kit's AoE abilities.
** [[Unused heroes]] (e.g. {{HeroIcon|Fathom}} and {{HeroIcon|Kali}}) can instead have other characters humorously commenting on their removal


== Trivia ==
==Punctuation==
* Speculation about character backstories, relationships, or interactions should not be included under trivia. If something is mentioned or implied in the text of the game, list it under "Lore" or "Character interactions" with appropriate citations instead.
===Commas===
* References to real life or outside media may be included if significant or relevant enough, including references to other Valve games. Hero/Item forum suggestions may be included if credited by the devs or if they share significant aspects with the final version of the hero/item.
Use commas to structure large numbers.  
* Community in-jokes should not be listed under trivia unless acknowledged in the game itself or by relevant sources (e.g. the [[Slork]] joke is referenced in voice lines and by developers).


If you would like to discuss the inclusion or removal of specific trivia points, use talk pages or the [https://discord.gg/q6TwMv3eEF Discord server].
==Grammar==
===Tense===
All sections should follow the same tense.


== Categorization ==
==Vocabulary==
Every page, including images, should have at least one category.
Formal use of language is mandatory on all wiki pages.
===Third Person===
*All articles are written in third person.
*Never use 'you' when referring to the reader.
===Formality and neutrality===
*Never use contracted forms.
*Never instruct readers in directing information, or presume readers knowledge about specific information. Do not inject point of view or subjective perspectives.
*Strategy sections may take some liberties with recommendations, but should also give reasons for why specific outcomes may or may not work.  


[[Category:Policies]]
==Categorization==
Every page should have a category, including images.
Please note that all contributions to The Deadlock Wiki are considered to be released under the Creative Commons Attribution-NonCommercial-ShareAlike (see Deadlock:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!
Cancel Editing help (opens in new window)

Pages included on this page:

Retrieved from "https://deadlock.wiki/Deadlock:Style_guide"