[Python-ideas] An exciting opportunity to update PEP 3156

[Senthil Kumaran]

On Mon, Sep 12, 2016 at 3:05 PM, Ned Batchelder <ned at nedbatchelder.com>
wrote:

> Why not put a notice at
> the top of the PEP indicating that it was accurate when it was accepted,
> but that changed have happened since then, see the docs for details?
>

I see PEP as the design document and docs as user-friendly documentation.
It helps to keep both of them up to date and in sync.
If an "Accepted" PEP is not updated, then folks landing on it will feel
misguided or confused if the read the docs later. Presenting a cohesive
story here is probably more work than simply keeping them in sync.

The history of decision changes is tracked in VCS, if that is desirable.

-- 
Senthil
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-ideas/attachments/20160912/a4f399a6/attachment.html>