[issue38460] 3.8 Release Notes: document asyncio exception changes

[Sebastian Rittau]

Sebastian Rittau  added the comment:

Closing per the comments by Andrew and Raymond and the fact that 3.8 has been 
released for quite some while now.

--
stage:  -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue38460] 3.8 Release Notes: document asyncio exception changes

[Sebastian Rittau]

Change by Sebastian Rittau :


--
resolution:  -> not a bug

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue38460] 3.8 Release Notes: document asyncio exception changes

[Raymond Hettinger]

Raymond Hettinger  added the comment:

> I'm personally not sure if we need to reflect *private*
> API change in Release Notes

The whatsnew 3.8 document is for significant changes to public APIs.  The 
changelog (built from the news entries) has much more extensive detail.  The 
main docs are where we put versionadded/versionchanged so that there is a 
source for knowing which features run in which versions of Python.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue38460] 3.8 Release Notes: document asyncio exception changes

[Andrew Svetlov]

Andrew Svetlov  added the comment:

> code that incorrectly imported directly from the submodules will break

That's true. Please note: incorrect code will break. The correct code keeps 
working.

I'm personally not sure if we need to reflect *private* API change in Release 
Notes.

Another question is: should Release Notes reflect all API updates? We strictly 
control `versionadded` and `versionchanged` usage in asyncio docs but don't do 
it for whatsnew files.

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue38460] 3.8 Release Notes: document asyncio exception changes

[Sebastian Rittau]

Sebastian Rittau  added the comment:

Also it seems there are various new arguments and methods in asyncio that are 
not in the release notes. (Via https://github.com/python/typeshed/issues/2313).

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue38460] 3.8 Release Notes: document asyncio exception changes

[Raymond Hettinger]

Raymond Hettinger  added the comment:

Yuri, would you propose an entry for this?

--
assignee: rhettinger -> yselivanov

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue38460] 3.8 Release Notes: document asyncio exception changes

[Raymond Hettinger]

Change by Raymond Hettinger :


--
Removed message: https://bugs.python.org/msg354595

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue38460] 3.8 Release Notes: document asyncio exception changes

[Raymond Hettinger]

Raymond Hettinger  added the comment:

Please put all suggestions in a single tracker entry.  Having multiple entries 
is more of a hindrance than a help.

--
assignee: docs@python -> rhettinger

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue38460] 3.8 Release Notes: document asyncio exception changes

[Ned Deily]

Change by Ned Deily :


--
nosy: +akuchling, asvetlov, rhettinger, yselivanov

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue38460] 3.8 Release Notes: document asyncio exception changes

[Sebastian Rittau]

New submission from Sebastian Rittau :

In Python 3.8 asyncio exceptions were consolidated into the new module 
"asyncio.exceptions". Previously they were spread out over several modules. 
While the documentation always mandated to import the exceptions from top-level 
"asyncio", code that incorrectly imported directly from the submodules will 
break.

--
assignee: docs@python
components: Documentation
messages: 354577
nosy: docs@python, srittau
priority: normal
severity: normal
status: open
title: 3.8 Release Notes: document asyncio exception changes
versions: Python 3.8

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com