+
+
+5.5 Writing style suggestions
+-----------------------------
+
+* "Click OK" and similar explanations of the utterly obvious should be
+ avoided. Keep the writing concise and to the point. Explain as much as
+ possible, with as few words as possible.
+* Do not fear repetitions, this is not artistic prose. Repeat important
+ keywords, rather than burden the user with synonyms made up on the spot.
+* Do not create headings for different ways of doing the same thing (<h>Via
+ the context menu</h>,...<h>Via hotkeys</h>). Headings separate new
+ concepts. To not add gratuitous sub-headings if there is very little
+ content per heading and you do not expect the article to grow.
+* If pages grow long, consider splitting them into sub-chapters at their
+ headings.
+* Nobody needs "the next paragraph is about the following" paragraphs.
+* When creating a <p class="note">NOTE</p>, *do not* put the word NOTE into
+ the note, the styling tells the user that it is a note.
+
+
+5.6. Encoding
+-------------
+
+* Pages should be encoded in UTF-8, with Unix-style newlines if possible
+ (although that's not critical). Avoid using verbatim special symbols, use
+ HTML character entities instead, for example for cursor arrows: →
+ ← ↑ ↓. Diacriticals on vowels and other special letters are
+ probably ok by now, so don't bother with é and friends, just type é.
+