Added this issue as a place for discussion and release blocker for 3.5.

Some modules in the "Improved Modules" section are out of lexicographic order: csv, ssl.

You wait until the day of release for 3.5.0 final, then create a "release blocker" because some items in the What's New documentation aren't lexographically sorted?

We tagged the release yesterday.  The installers are already built.  I am not holding up the release for this.

Sorry, but I thought that such issue already exist.

Yury and Elvis made a lot of changes in What's New in few last days and continue to edit it. Are these changes included in 3.5.0 final? Without their What's New just isn't ready.

Personally I found few interesting Python 3.5 features just reading recent commit log for Doc/whatsnew/3.5.rst. Without this they would be unknown for me.

>-constructor.  All converters defined in config parser (either by subclassing or
>+constructor, or  All converters defined in config parser (either by subclassing or

Looks as unfinished editing.

First, the What's New on the website is generated from the 3.5 branch in hg.python.org.  So it's already up-to-date.  That's the one most people will refer to.

Second, if the What's New was really that horribly out of date, and we wanted people who download the documentation to get a fresh one, we could easily update the downloadable documentation; it ships separately.  There would be no need to hold up the release for this.

And finally, I actually backported the What's New in 3.5 to the 3.5.0 release yesterday.  You can only see evidence of it in one place right now:
    https://hg.python.org/releasing/3.5/rev/955911b49328

New changeset 59f7007fbf3c by Yury Selivanov in branch '3.5':
whatsnew/3.5: Reorder stuff (issue #25082).
https://hg.python.org/cpython/rev/59f7007fbf3c

New changeset aa288ad94089 by Yury Selivanov in branch '3.5':
whatsnew/3.5: Fix typo (issue #25082)
https://hg.python.org/cpython/rev/aa288ad94089

> Some modules in the "Improved Modules" section are out of lexicographic order: csv, ssl.

Yes, these two weren't properly ordered by *2nd* letter.  Fixed.

>>-constructor.  All converters defined in config parser (either by subclassing or

Good catch.  Both Elvis and I are going to do a final thorough pass over the whatsnew to fix hiccups like this one.  In no way this should be a release blocker.

> Second, if the What's New was really that horribly out of date, and we wanted people who download the documentation to get a fresh one, we could easily update the downloadable documentation; it ships separately.  There would be no need to hold up the release for this.

I'd say it's in a ready shape.  We've spent tons of time refining it, syncing NEWS items first, looking for undocumented changes in commits without NEWS updates, syncing docs by versionadded/changed (both ways), etc.  I'm fairly confident that 99% of changes are now documented.  We'll fix the remaining typos/formatting issues in a few hours.

> And finally, I actually backported the What's New in 3.5 to the 3.5.0 release yesterday.

Thanks for doing that, Larry!

I'm hoping to release 3.5.0 final in the next hour or two.  I don't want to hold up the release for your changes.  However, when you're done making changes to the document, and they're all checked in, let me know and I'll manually build it and push it to the web site.

Larry, it looks like the "Detailed Release Information" link on the release page still points to rc3, which is a 404 now.

Also, there doesn't seem to be a link to the "What's new" document, only a Misc/NEWS link.

The "Detailed Release Information" link is correct.  You probably just have an old cached copy of something.

I could add a "What's New" link somewhere.

Though both of these things are interesting, neither of them is relevant to this issue.  Maybe you could jump on IRC and report them in real time?

Could I get a little note in the collections.abc section that the new ABCs "Generator", "Coroutine" and "Awaitable" are available as backports in the "backports_abc" package on PyPI?

https://pypi.python.org/pypi/backports_abc

I'd like to prevent others from innocently feeling a needless need to roll their own solution.

Larry,

Please rebuild the documentation, we've pushed the last round of edits in 746add37495c.

Also, could you please merge 3.5 into default -- I don't know how to resolve some conflicts after your 3.5.0 -> 3.5 merge.

> I could add a "What's New" link somewhere.

Thanks for adding it! Can we make it a bit more prominent by moving it to the top of the page?  PEP links are important, but what's new is more digestible.

Stefan, I've added a link to your package.

And can we point https://docs.python.org/3/ to 3.5 docs?

I don't know how to do it.  I asked the Documentation Expert member of the Python 3.5 release team, but it seems he's afk at the moment.  I'm trying to find someone else who knows how to do it.

Thanks, Yury!

ssl should be between sqlite3 and subprocess.

> ssl should be between sqlite3 and subprocess.

It makes sense that ssl module description follows the socket module.

Many thanks to Yury and Elvis for your work on What's New.

Thanks, Serhiy!