This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author ncoghlan
Recipients brett.cannon, ezio.melotti, ncoghlan, rhettinger, stutzbach, terry.reedy, yselivanov
Date 2016-01-01.05:12:35
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1451625155.88.0.0510243552968.issue25637@psf.upfronthosting.co.za>
In-reply-to
Content
From a documentation perspective, I'd suggest breaking the ABC module documentation at https://docs.python.org/3/library/abc.html into three subsections:

29.7.1 Defining Abstract Base Classes

This would include the existing docs for ABC, ABCMeta, abstractmethod and get_cache_token.

29.7.2 Syntactic ABCs

New section containing the documentation for the ABCs relocated from collections.abc

29.7.3 Deprecated decorator API

The docs for abstractclassmethod, abstractstaticmethod and abstractproperty can be moved out of the main ABC definition docs, since the only reason to use them now is for single source Python 2/3 compatibility, or compatibility with Python 3.2.
History
Date User Action Args
2016-01-01 05:12:35ncoghlansetrecipients: + ncoghlan, brett.cannon, rhettinger, terry.reedy, stutzbach, ezio.melotti, yselivanov
2016-01-01 05:12:35ncoghlansetmessageid: <1451625155.88.0.0510243552968.issue25637@psf.upfronthosting.co.za>
2016-01-01 05:12:35ncoghlanlinkissue25637 messages
2016-01-01 05:12:35ncoghlancreate