[Python-Dev] PEP 287: reStructuredText Standard Docstring Format

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.