From 0e44aea051e1d21713d92a222f2c73fbd28908d7 Mon Sep 17 00:00:00 2001 From: Jack Hodgkinson <30505104+jhodgdev@users.noreply.github.com> Date: Mon, 7 Feb 2022 16:07:22 +0000 Subject: [PATCH] Small changes to style guide --- docs/meta/style-guide.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/docs/meta/style-guide.md b/docs/meta/style-guide.md index 3a129c5..664549c 100644 --- a/docs/meta/style-guide.md +++ b/docs/meta/style-guide.md @@ -2,9 +2,13 @@ This document includes a couple of notes on how Agora documentation should be written and formatted. +## British/American spelling and grammatical differences + +The difference between British and American English is wider than a lot of people presume. Authors are permitted to use whichever of the two they learned and therefore feel more comfortable with. The only exception to this is when writing changes that would result in a 'mixing' of styles e.g. having 'color' in a sentence and 'colour' in the next. In this instance please alter your use of the language to maintain consistency. + ## Capitalised words -The following words should always be render capitalised: +The following words should always in the forms below: - Agora - Liqwid @@ -34,6 +38,13 @@ The following words should always be rendered lower-case (unless used at the beg - governance +## ADA, Ada, ada + +Cardano's native token suffers from a frustrating variety of acceptable forms. Reputable sources can be found using all three variants listed in the header. As such, no usage shall be mandated with two caveats: + +1. Whilst the name of the currency is subject to variance, its 'symbol' is unambiguously 'ADA'. Therefore when talking about amounts e.g. 'Trillian deposits 100ADA', use 'ADA'. +2. Exercise _reasonable consistency_. The use of an 'Ada' at the beginning of the document and an 'ada' 3000 words later is not something worth losing sleep over. Inconsistency within paragraphs or (gasp!) _sentences_ should always be avoided. + ## Avoid The following practices should be avoided: