>>>>> "Ian" == Ian Bicking <[EMAIL PROTECTED]> 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.

Skip
_______________________________________________
Doc-SIG maillist  -  [email protected]
http://mail.python.org/mailman/listinfo/doc-sig

Reply via email to