From 270764c9a03f5656369ee8eb4d483642812e25c2 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 22 Jul 2015 17:33:24 +0200 Subject: m style guide MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- doc/style-guide-for-documentation | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/doc/style-guide-for-documentation b/doc/style-guide-for-documentation index ff65d2e..88217e7 100644 --- a/doc/style-guide-for-documentation +++ b/doc/style-guide-for-documentation @@ -91,6 +91,35 @@ Some examples: Incorrect: A solar-day on Mars ‘Solar’ is an adjective. Adjectives and nouns are never joined. + Incorrect: A speech-to-text technology + More incorrect: A speech to text-technology + Most incorrect: A speech to text technology + Most incorrect: A speechtotexttechnology + Correct: A speech-to-text-technology + Incorrect: A speech-to-texttechnology + ‘speech-to-text’ is a noun, hence one word. ‘technology’ is also + a noun. The two nouns must be joined because they form a single + noun. However, because ‘speech-to-text’ is a phrase where the words + are joined by hyphens (they most be joined by hyphens because it is + a phrase,) ‘speech-to-text’ and ‘technology’ most be joined with a + hyphen, however, using a space in a case like this is tolerable. + + + + + +Full form versus contracted form +-------------------------------- + +Contractions are not acceptable, except, for ‘-n't’, for example +‘don't’ and ‘won't’. Additionally, ‘o'clock’ is allowed because +it is considered mandatory in contemporary use, consequentially +‘of the clock’ must not be written. +Contractions are especially intolerable when it is ambiguous by +itself even if the full sentence makes it unambiguous. Therefore +‘-'s’ and ‘-'d’ most never be used. + + -- cgit v1.2.3-70-g09d2