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