Changes between Version 26 and Version 27 of EnglishStyleGuide

Timestamp:

Aug 21, 2018, 5:41:49 PM (6 years ago)

Author:

Nescio

Comment:

Be precise; classes

EnglishStyleGuide

@@ -55 +55 @@
 An object should always be referred to using the same word everywhere in the
 game, and an action should always be referred to using the same verb.
-
 For example, if there is a unit type called ‘female citizen’, always refer to it
 as such, do not also use alternative forms such as ‘females’, ‘women’, and so
 on. Even in the same paragraph or sentence, you should use the same term.
+
+Always be precise. E.g., if a technology multiplies the melee attack damage of cavalry by 1.2, the tooltip should be "cavalry +20% melee attack damage", not "melee cavalry +20% attack damage".
+
+Furthermore, there should be a bijection between descriptions and classes. E.g. if a technology affects the Citizen class, write "Citizens"; if it affects the Soldier class, write "Soldiers"; if it affects only units that have both the Citizen and the Soldier class, write "Citizen Soldiers"; however, if it affects the "CitizenSoldier" class instead, then write "Citizen-Soldiers".
 
 For specific words that you should use or avoid in 0 A.D. gameplay texts, see the tables below: