[Framework-Team] Re: Fwd: Including a Documentation section in each PLIP

[Wichert Akkerman]

Previously Martin Aspeli wrote:
> I do agree that documentation should be part of PLIPs. One simple thing 
> would be to just have a free-text on the PLIP that identifies the 
> documentation that is either required or extant for the PLIP, so that 
> people who look at the PLIP later can find a pointer to where there's 
> more documentation.

I would much rather see the equivalent of the what-is-new-in-python-x.y
documents: a thorough explanation of every change, its rationale, and
the inpact that has on both existing and new code. That would then be a
very useful starting point for the documentation team to update/extend
other documentation.

Wichert.

-- 
Wichert Akkerman <wichert at wiggy.net>    It is simple to make things.
http://www.wiggy.net/                   It is hard to make things simple.