>>>>> "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