RetroSearch Browse

Mon Jun 14 12:53:59 EDT 2004 · https://mail.python.org/pipermail/python-dev/2004-June/045385.html

On Sat, Jun 12, 2004 at 01:33:49AM +0200, "Martin v. Löwis" wrote:
 > I don't like documentation inside PEPs. Documentation should live
 > inside the documentation.

On Friday 11 June 2004 07:37 pm, Christian Robottom Reis wrote:
 > Well, maybe I should have used the word "change rationale" instead of
 > documentation. In any case, the document describes the original problem
 > statement, potential solutions, and the process through which a solution
 > was devised.

This is exactly the historical record PEPs were intended to provide; I think 
the PEP should be complete with respect to the rationale.

The documentation should certainly describe the final behavior, but that 
shouldn't preclude a finished PEP.

  -Fred

-- 
Fred L. Drake, Jr.  <fdrake at acm.org>
PythonLabs at Zope Corporation

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://mail.python.org/pipermail/python-dev/2004-June/045385.html below:

[Python-Dev] LC_NUMERIC proto-PEP