EDITING



Wiki editing guideline
======================

Ideally, text authors should apply only semantic (not visual) markup.
Unfortunately, Markdown and Mediawiki formats only cover visual markup.

These are suggestions for pseudo-semantic Markdown/Mediawiki markup,
suitable for post-processing into both web-based and print formats.

  * Use emphasis + doublequote for foreign terms.
  * Use doublequote + emphasis for titles.
  * Use strong emphasis only for essential keywords, and very sparsely.
  * Use blockquote only for citation (not as emphasis for other blocks).
  * Use blockquote for citation block (not blockquote + other quotes).
  * Use bibliography at each citation (preferrably at the end).
  * Use direct link (not bibliography) for "see also" style refences.
  * Use canonical URL in hyperlink (not wikilink or relative URL).
  * Use square brackets for meta comments (not paranthesis).
  * Use verbatim only for code and shell commands.
  * Fix visual abuse of punctuation or indentation in quoted text.

 -- Jonas Smedegaard <dr@jones.dk>  Mon, 15 Dec 2014 15:28:48 +0100