[Doc-SIG] Python docs in reST

Skip Montanaro skip at pobox.com
Thu May 19 15:47:48 CEST 2005

>>>>> "Ian" == Ian Bicking <ianb at colorstudy.com> writes:

    Ian> Skip Montanaro wrote:
    >> >> 1. reference docs: ...
    >> >> 
    >> >> 2. user documentation: ...
    Ian> I think that's a good distinction.  And like several people I'm not
    Ian> very interested in 1.
    >> Ah, but I started this thread thinking about #1.  <wink>

    Ian> Well, not the #1 that Martin described (epydoc-like).  The Python
    Ian> documentation is a perfect example of #2 -- documentation written
    Ian> completely by hand that provides a structured and concise
    Ian> description of a module.  

Yes, mea culpa.  I had them flipped.  Dunno why.


More information about the Doc-SIG mailing list