CLiki Style
A typical CLiki page consists of an article, ideally in Inverted Pyramid style, followed optionally by comments (emphasized with the <em> tag) separated by <hr /> tags.

Tips:

  • The first sentence of an article is used as a summary in search results and topic listings. Try to make it brief and informative.
  • The Inverted Pyramid style is the recommended way to write CLiki pages. The ideal article begins with the conclusion, expressed as a single sentence. The first or next paragraph of text should then go on to give the most important points, leaving the details and supporting information to be expounded in the rest of the article.
  • Don't use relative date or version references. Terms like "new", "old", "recently" or "a month ago" don't help anyone if they don't know how long ago you wrote them. Try "in 2002", "as of 2004.08.20", "version 4" or some absolute term instead.
  • More advice on good style can be found in Constance Hale's book Sin and Syntax: How to Craft Wickedly Effective Prose.

Q: should the page name appear in the first sentence? This leads to a lot of repetition in the search results. -- Roland Kaufmann (See programming language, for instance.)