Changes between Version 42 and Version 43 of EnglishStyleGuide

Timestamp:

Jan 14, 2019, 2:27:13 PM (5 years ago)

Author:

Nescio

Comment:

reordered

EnglishStyleGuide

@@ -4 +4 @@
 
 
-== Calender years
-
-The name of the game is '''0 A.D.''', which includes dots, for stylistic reasons.
-However, dots are not used when writing down years. E.g. Augustus was emperor of Rome from 27 BC until his death in 14 AD.
-
-||='''Good''' =||='''Bad'''       =||
-||BC           ||B.C., BCE, B.C.E. ||
-||AD           ||A.D., CE, C.E.    ||
-
-
-== Capitalization
-
-Use [https://en.wikipedia.org/wiki/Letter_case#Title_case title case] for:
-- Button captions
-- Entity names (including generic names of phases, structures, technologies, and units)
-- Key names
-- Proper names
-
-Never use full capitalization.
-
-||='''Good'''                   =||='''Bad'''                    =||
-||Click the Citizen Soldier icon ||Click the CITIZEN SOLDIER icon ||
-||Hold Shift and click           ||Hold shift and click           ||
-
-
-== Cursor vs Mouse
-
-Mind the difference between the cursor (virtual) and the mouse (physical).
-
-
-== Dynastic factions
-
-||='''singular:'''     =||='''plural:'''       =||='''adjective:'''      =||
-||''founder of dynasty''||''members of dynasty''||''belonging to dynasty''||
-||Achaemenes            ||Achaemenids           ||Achaemenid              ||
-||Maurya                ||Mauryas               ||Mauryan                 ||
-||Ptolemy               ||Ptolemies             ||Ptolemaic               ||
-||Seleucus              ||Seleucids             ||Seleucid                ||
-
-
-== English Orthography
-
-Use US English spelling. For example:
+== Orthography
+=== English spelling
+Use American English spelling. For example:
 
 ||='''US''' =||='''UK''' =||
@@ -59 +19 @@
 ||traveler   ||traveller  ||
 
-Also, a serial comma is used when listing three or more items. E.g. "Available to Britons, Gauls, and Iberians." or "Capture, Melee, or Ranged." and not "Britons, Gauls and Iberians." or "Capture, Melee or Ranged."
-
 Check what you type. E.g. the verb to pron''ou''nce is always spelled with ''ou'', but the noun pron''u''nciation is spelled with only ''u''.
 
 
-== Greek and Latin
-
+=== Calender years
+The name of the game is '''0 A.D.''', which includes dots, for stylistic reasons.
+However, dots are not used when writing down years. E.g. Augustus was emperor of Rome from 27 BC until his death in 14 AD.
+
+||='''Good''' =||='''Bad'''       =||
+||BC           ||B.C., BCE, B.C.E. ||
+||AD           ||A.D., CE, C.E.    ||
+
+
+=== Dynastic factions
+
+||='''singular:'''     =||='''plural:'''       =||='''adjective:'''      =||
+||''founder of dynasty''||''members of dynasty''||''belonging to dynasty''||
+||Achaemenes            ||Achaemenids           ||Achaemenid              ||
+||Maurya                ||Mauryas               ||Mauryan                 ||
+||Ptolemy               ||Ptolemies             ||Ptolemaic               ||
+||Seleucus              ||Seleucids             ||Seleucid                ||
+
+
+=== Greek and Latin
 Greek words and proper names are Latinized everywhere, except in the specific name. 
 
@@ -91 +67 @@
 
 
-== Spacing
-
-* Only use one space, not two, after a full stop to end a sentence.
-* Do not use spaces ''before'' “large” characters (e.g. ?, !, :, %).
-
-
 == Terminology
-
 In texts that the user needs to understand, such as menu entries, help
 tooltips, and similar, you must be consistent with the vocabulary that you use.
@@ -113 +82 @@
 
 For specific words that you should use or avoid in 0 A.D. gameplay texts, see the tables below.
+
 
 === Actions
@@ -124 +94 @@
 ||Train (human units)              ||Build, construct, recruit, produce ||
 
+
+=== Cursor vs Mouse
+Mind the difference between the cursor (virtual) and the mouse (physical).
+
+
 === GUI
 
@@ -129 +104 @@
 ||Icon         ||Image, Picture, Portrait, Sprite, Thumbnail ||
 
+
 === Resources
+
 ||='''Good''' =||='''Bad''' =||
 ||Food         ||            ||
@@ -136 +113 @@
 ||Wood         ||Lumber      ||
 
+
 === Stats
 
@@ -142 +120 @@
 ||Health              ||Hitpoints, HP                     ||
 ||Melee attack range  ||Attack range, Melee range, Range  ||
+
 
 === Structures
@@ -154 +133 @@
 ||House        ||Dwelling, Home, Shack                      ||
 ||Storehouse   ||Drop Site, Mining Camp, Storage Pit        ||
+
 
 === Units
@@ -179 +159 @@
 
 
-== Unicode
-
+== Typography
+
+=== Capitalization
+Use [https://en.wikipedia.org/wiki/Letter_case#Title_case title case] for:
+- Button captions
+- Entity names (including generic names of phases, structures, technologies, and units)
+- Key names
+- Proper names
+
+Never use full capitalization.
+
+||='''Good'''                   =||='''Bad'''                    =||
+||Click the Citizen Soldier icon ||Click the CITIZEN SOLDIER icon ||
+||Hold Shift and click           ||Hold shift and click           ||
+
+
+=== Punctuation and spacing
+* A serial comma is used when listing three or more items. E.g. "Available to Britons, Gauls, and Iberians." or "Capture, Melee, or Ranged." and not "Britons, Gauls and Iberians." or "Capture, Melee or Ranged."
+* Only use one space, not two, after a full stop to end a sentence.
+* Do not use spaces ''before'' “large” characters (e.g. ?, !, :, %).
+* For parenthetical remarks, parentheses (which have spaces on the outside, but not on the inside) are the default, en-dashes 
+– which have spaces both inside and outside – can also be used occassionally if it looks better; the usage of em-dashes—which have spaces neither inside nor outside—is better avoided.
+
+
+=== 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.