From 8fa22eec6322b600b84fba496d509fdc4047f296 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 22 Jul 2015 17:11:52 +0200 Subject: style guide examples 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 | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/doc/style-guide-for-documentation b/doc/style-guide-for-documentation index d51dd74..ff65d2e 100644 --- a/doc/style-guide-for-documentation +++ b/doc/style-guide-for-documentation @@ -54,6 +54,42 @@ Hyphen should however be used if it significantly improves readability. Note well, it is hypercorrect (incorrect) to replace a space with a hyphen to emphasis linking between words to avoid ambiguity. +Some examples: + Correct: Pro-Russian forces + ‘Pro-’ is prefix and ‘Russian’ as capitalisation on its + first letter, requiring a hyphen. + + Incorrect: I am pro-GPL + Correct: I am pro GPL + ‘Pro’ is not a prefix this case, but rather a preposition, + you have an opinion rather than being an object. + + Incorrect: Linux powered computer + Correct: Linux-powered computer + Incorrect: Linuxpowered computer + In the first example, powered with past tense of the verb + power. Note, it is almost grammatically correct, but it does + not mean what was intended, the only grammatical error is that + ‘computer’ needs to be replace by ‘a computer’, ‘computers’ or + ‘the computer’. In the second and third example the tense is + present, but the computers are powered by Linux rather than that + Linux used to power the computer. The third example is however + incorrect because Linux is a proper noun. + + Incorrect: Solar powered computer + Correct: Solar-powered computer + Preferred: Solarpowered computer + Similar to the previous group of examples. + ‘Solar’ is not a noun (in this case), but an adjective, so the + first example is incorrect. ‘Solar’ and ‘powered’ needs to be + joined to form a single, four-morpheme (both ‘solar’ and ‘powered’ + are two-morpheme), word. This can either be done with a hyphen + or by a complete join without space or hyphen, the latter is + preferred. + + Correct: A solar day on Mars + Incorrect: A solar-day on Mars + ‘Solar’ is an adjective. Adjectives and nouns are never joined. -- cgit v1.2.3-70-g09d2