On Tuesday 12 June 2007 11:08, Lukas Ocilka wrote:
I guess, we could write more examples into the current documentation and/or write a chapter about "Standard building blocks" or something similar...
Maybe we could "learn" how to document it from another documentation of another language...?
Actually, IMHO we need two kinds of documentation:
(1) Reference - concise, yet complete. But all by all means (unlike most man
pages) with examples for the most common use cases.
(2) Tutorial - explanatory, not necessarily covering all aspects,
concentrating on didactics, with pointers to the reference.
AFAICS we have only a subset of (1) and beginnings of (2).
CU
--
Stefan Hundhammer