Liquipedia:Style Guide

Overview[edit]

This article serves as a style guide for Wiki articles concerning Dota 2. When writing in and editing the Wiki, please conform to these guidelines, as that will help us keep this resource clean and tidy.

Spelling[edit]

Upper and lower case[edit]

  • Hero names and titles are upper cased;
    • Nature's Prophet, not nature's prophet
    • Shadow Fiend not shadow fiend.
  • Item names are upper cased;
    • Mekansm, not mekansm
    • Blink Dagger, not blink dagger.
  • Compound expressions, such as Sacred Relic, Blink Dagger, Dust of Appearance are upper cased. However, when used in a more casual context and as a single word, they are lower case: relic, dagger, dust.
  • Primary Attributes are always singular and upper case; Strength, Agility, Intelligence, not Strengths, agilities.
  • When giving the remaining Hit Points of a unit, use Hit Points, HP or (sparingly) health . Do not use hp or hit points
  • Esports should be spelled with lower case s (as esports, not eSports) unless it is part of a name (team name, brand name, tournament name etc.)

Names and Substitutions[edit]

  • Do not abbreviate, unless stylistic diversity commands it. The following guidelines apply:
  • Two Word units can be compressed when unambiguous:
    • Smoke of Deceit → Smoke
    • Gem of True Sight → Gem
    • but not: Animal Courier → Courier
  • The following substitutions are acceptable, generally, if your term is descriptive and functional, it can be used; They consist of representative examples, use common sense to guess the remaining ones!
Scythe of Vyse → Sheepstick
Upgrades → Necro 1/2/3, Dagon 1-5

Bolding[edit]

  • If possible, bold the first instance of the page's title within the text. This may be unnecessary for longer titles.

Punctuation[edit]

  • Basic punctuation rules apply.
  • Try to avoid use of excessive exclamation marks (!!) or question marks (??)
  • When using a hyphen to introduce a list of one item, or to change a thought mid-sentence, use a space before and after that hyphen:
    • Here is a thought - I want to say something on a small tangent.
  • When beginning a new sentence, use only a single space after a full stop (period).
    • Early-game Mutalisks are harassment units and should be used as such. They should never directly engage an army.

Punctuation in Lists[edit]

Lists with individual items only do not have periods, if there are complete sentences, all items in the list have periods at the end.

  • Individual
  • Item
  • List

A list with sentences:

  • This list has sentences.
  • Each sentence has a period.

Note that if a list has both items and sentences (e.g. Build Orders), full sentences receive a period, all the others may be left without.

Numbering[edit]

  • For numbers taken directly from Dota 2 gameplay, use numerals.
    • When you have 2250 gold, purchase a Blink Dagger.
    • Level 4 Blur gives Phantom Assassin 50% Evasion.
  • For all other numbering up to twenty, use their corresponding English words.
    • A low base health support hero should purchase two Bracers to increase its health pool.
  • For numbers above twenty, use numerals once again.
    • A Broodmother cannot spawn 24 Spiderlings.

Naming Conventions[edit]

Players[edit]

  • When referencing professional gamers, use their most common nickname.
  • Team tags should generally not be included due to the issues that arise if a player moves teams or changes their tag. An example, with NiP disbanding, all IDs with NiP in the name are out of date. So for in line text remove all tags.
    • The offlane player AdmiralBulldog was most well known for his advanced strategic capabilities.

Teams[edit]

  • When referencing professional teams you may use abbreviations. If referring to the team multiple times in the same piece, try and alternate the names so that it does not become monotonous.
    • Team Liquid, Liquid, TL
  • In info boxes, team cards or titles, please use the complete name of the team.
    • Natus Vincere or Ninjas in Pyjamas

Images[edit]

  • When uploading infobox images, please use the full name of the building, unit, build, technique or player in question.
    • Sunkencolony.jpg, Darktemplar.jpg, 14Commandcenter.png, Boxer.png.

Strategy Articles[edit]

Titles and Links[edit]

  • In the article name, your race and your opponent's race should be included if ambiguous, i.e. Terran Counter To Greedy Zerg; however, if an article is already in a certain section, omit the names on the overview page when possible. E.g.: Terran Counter To Zerg 2 Hatch Pressure becomes Counter To 2 Hatch Pressure when it is clearly located in the TvZ section. If this is unclear to you, take a look at the Strategy Mainpage and look at the examples there.
  • Connectors like "to" "with" "vs." are all lower case. E.g. Terran Counter to 9 Pool instead of Terran Counter To 9 pool
  • All Strategies receive a "(vs. [RACE])" in the end. This is to disambiguate similar strategies, such as 1 Gate Core, which can be used in both PvP and PvT. E.g., 9 Pool (vs. Protoss), not "9 Pool (vs Protoss)" (dot missing) or simply "9 Pool".
  • Internal links (especially to Units or Strategies) should be used at least once per article, and at most once per section.
    • "Zealots are good at killing other zealots." In this case you link to the zealots article the first time the word 'zealots' appears, but not the second time.

Build orders[edit]

  • [Supply Number] - Building; Building is full name. E.g. 9 - Supply Depot, not 9 Depot.
  • When giving construction percentage: "@65% Hive - [do this]"; Not "@50% Lair build Mutalisks" (hyphen missing) or "9 @ 40% - [do this]" (supply number not needed and building/upgrade missing).

Article Design[edit]

  • Headings are supposed to be meaningful; i.e. not "NOTE 1" to "NOTE 5".
  • Do not include headings with a question mark but formulate them in an expressive way. "Why use this strategy?" could become "theory" and similar.
  • If we find any references to unwritten articles before release, about which we do not know how they would be filled out, they will be purged.

Point of view[edit]

  • As long as it is unambiguous, speak with the reader as a 2nd person, e.g.:
    • If you see the Terran put up three Starports, get a Spire as soon as possible.
  • The above avoids the unclear plural / singular status of the Races and also the awkward use of article; compare these (wrong) variants to see why addressing the user as "you" is more elegant:
    • If Zerg see the Terran put up three Starports, they need to ...
    • If the Zerg sees the Terran put up three Starports, he needs to get ...
  • Avoid use of repetition when referring to the opponent. Use "he or she" or "his or her" if necessary. Consider the following sentence:
    • If the Terran fast expands, the Terran will mostly likely have less marines.
    • This is much less repetitive: If the Terran fast expands, he or she will mostly likely have less marines.
  • The only exception is, naturally, where the reader's point of view is not clear, for example in a 2on2 strategy.

References[edit]

VOD linking[edit]

  • Link to the original VOD if possible.