Changes between Version 1 and Version 2 of EnglishStyleGuide

Timestamp:

Jan 6, 2018, 10:34:34 PM (6 years ago)

Author:

Adrián Chaves

Comment:

--

EnglishStyleGuide

@@ -1 @@
-TODO
+This guide provides some ground rules to write user-facing texts for 0 A.D.
+
+
+== Terminology
+
+In texts that the user needs to understands, such as menu entries, help
+tooltips, and similar, you must be consistent with the vocabulary that you use.
+
+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.
+
+For specific words that you should use or avoid in 0 A.D. gameplay texts, see the tables below:
+
+=== Actions
+
+||=Use =||=Avoid=||
+||Gather||Collect||
+||Train ||Produce||
+
+=== GUI
+
+||=Use =||=Avoid =||
+||Icon  ||Portrait||
+
+=== Stats
+
+||=Use =||=Avoid      =||
+||Health||Hitpoints, HP||
+
+=== Units
+
+||=Use                                        =||=Avoid                     =||
+||Cavalry citizen soldier                      ||                            ||
+||Citizen (cavalry or infantry, female or male)||Worker                      ||
+||Citizen soldier (cavalry or infantry)        ||                            ||
+||Female citizen                               ||Female, female worker, woman||
+||Infantry citizen soldier                     ||                            ||