Antoine Pitrou added the comment: > > The problem for documentation use is that we're christening it as an > > official API, and thus it becomes more difficult to refactor the > > inheritance hierarchy. > > So what would you suggest?
Hmmm... Well I guess your proposal makes sense :-) Aka. having a documented ABC, and then a private base implementation. Otherwise, you can also document the methods without saying precisely to which class they belong, which I started doing on asyncio, but apparently it confuses some people. ---------- _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue19842> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com