This guide provides some ground rules to write user-facing texts for 0 A.D.

== Emphasis

Do not use uppercase to emphasize text. Instead, use a bold font if possible, or single quotes otherwise.

For example:

||=Good                          =||=Bad                         =||
||Click the 'citizen soldier' icon||Click the CITIZEN SOLDIER icon||


== 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=||
||Collect (treasures)||       ||
||Gather (resources) ||Collect||
||Train (units)      ||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                     ||                            ||


== Unicode

We have a somewhat complete Unicode support, do not limit yourself to ASCII and learn how to use [https://en.wikipedia.org/wiki/Unicode_input Unicode input] in your system.

For example:

||=Good=||=Bad=||
||…     ||...  ||