diff options
| author | Mattias Andrée <maandree@operamail.com> | 2015-07-22 17:11:52 +0200 |
|---|---|---|
| committer | Mattias Andrée <maandree@operamail.com> | 2015-07-22 17:11:52 +0200 |
| commit | 8fa22eec6322b600b84fba496d509fdc4047f296 (patch) | |
| tree | e384cf777e4b8098aba08ad2e52f01f5dc644f9e /doc/style-guide-for-documentation | |
| parent | m (diff) | |
| download | mds-8fa22eec6322b600b84fba496d509fdc4047f296.tar.gz mds-8fa22eec6322b600b84fba496d509fdc4047f296.tar.bz2 mds-8fa22eec6322b600b84fba496d509fdc4047f296.tar.xz | |
style guide examples
Signed-off-by: Mattias Andrée <maandree@operamail.com>
Diffstat (limited to '')
| -rw-r--r-- | doc/style-guide-for-documentation | 36 |
1 files changed, 36 insertions, 0 deletions
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. |