quality documentation

9.6: news.addx/doc's/good examples:

. according to Xah Lee

here are doc's that co.python's should emulate:

http://java.sun.com/j2se/1.4.2/docs/api/index.html

http://reference.wolfram.com/mathematica/guide/Mathematica.html

http://msdn.microsoft.com/en-us/library/hbxc2t98(VS.85).aspx

. it seems to be the oss`culture,

-- Perl, Python, Unix, Apache etc[in the unix anti-cs spirit] --

that their documentation exhibit

jargon abuse, rambling, author [self-promotion], or hodgepodge

but this doesn't apply to Gnu's Not Unix project.

GNU docs are geeky in comparison to the above commercial docs;

but, the GNU project in general (gnupress.org)

has excellent documentation.

.

10.9: adda/doc files:

. instead of having long comments,

have in addition to head and body files

a doc file that includes docs for that unit

wherein you redo the routine in english (your own words) .