From c18233fc935f073f3d5089e37630cfb1a3e50542 Mon Sep 17 00:00:00 2001 From: Henrik Tidefelt Date: Sat, 20 Mar 2021 10:11:28 +0100 Subject: [PATCH] Add section on English natural language text Includes addressing review comment by Hans regarding contractions. --- styleguide.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/styleguide.md b/styleguide.md index 73c4557d7..f942f0893 100644 --- a/styleguide.md +++ b/styleguide.md @@ -210,3 +210,13 @@ When a grammar rule is mentioned in the text, the rule shall be formatted with t ``` The node shall contain a \lstinline[language=grammar]!stored-definition! that… ``` + +## English natural language text + +This section gives guidelines for how the natural language text in English should be written. + +The text is written in American English. + +### Contractions + +Avoid contractions such as _isn't_ or _won't_; write _is not_ or _will/would not_ instead.