[Python-Dev] PEP 287: reStructuredText Standard Docstring Format (original) (raw)

Jeremy Hylton jeremy@zope.com
Wed, 3 Apr 2002 16:53:55 -0500

"GvR" == Guido van Rossum <guido@python.org> writes:

GvR> [Jeremy]

To paraphrase Aristole, wisdom comes from choosing wisely in the particular situation.

GvR> I thought that wisdom came from experience, and experience from GvR> lack of wisdom. (Or is that common sense? There's a lot of GvR> wisdom in common sense.)

Oh, yes, I remember that one, too :-). Don't think it was Aristotle, but the saying goes: Good decisions come from experience; experience comes from bad decisions.

GvR> I believe that reStructuredText comes from a lot of experience: GvR> long discussions about requirements in the doc-sig, and GvR> experience with e.g. Zope's StructuredText (which definitely GvR> represents the "lack of experience" position IMO).

I believe that reST is a good structured text design, and I think it would be good to use it, e.g., to replace Zope's StructuredText.

Jeremy