[Python-Dev] What's new 2.x in 3.x docs.
g.brandl at gmx.net
Mon Jan 24 20:26:00 CET 2011
Am 23.01.2011 02:48, schrieb Nick Coghlan:
> On Sun, Jan 23, 2011 at 7:23 AM, Raymond Hettinger
> <raymond.hettinger at gmail.com> wrote:
>> On Jan 22, 2011, at 11:04 AM, Terry Reedy wrote:
>>> The 3.x docs mostly started fresh with 3.0. The major exception is the What's new section, which goes back to 2.0. The 2.x stuff comprises about 650KB in the repository and whatever that translates into in the distribution.. I cannot imagine that anyone who only has 3.x and no 2.x version would have any interest in the 2.x history. And of course, the complete 2.x history will always be available with the latest 2.7.z. And the cover page for 3.x could even say so and include a link. So why not remove it from the 3.2 release (and have two separate pages for the online version)?
>> I think there is value in the older whatsnew docs. The provide a readable introduction to various features and nicely augment the plain docs which can be a little dry.
>> +1 for keeping the links as-is. Removing them takes away a resource and gains nothing.
> They're also a useful resource when developing compatibility guides
> for projects that target older versions (including ones that support
> py3k via 2to3).
> With the latest 3.x release always being at the top, I agree with
> Raymond that retaining the history is a better option.
More information about the Python-Dev