Re: [Python-Dev] [Python-checkins] cpython: Fix reST label for collections ABCs.
On Jun 3, 2011, at 10:27 AM, eric.araujo wrote:
Fix reST label for collections ABCs.
The previous markup hijacked the abstract-base-classes glossary entry, which resulted in the HTML linking to collections.abc when defining the generic ABC concept. Now the glossary links to the abc module.
I think the users are better served by links to collections.abc, io.abc, etc. For the most part, glossary readers will be interested in actual abstract classes than in the underlying implementation. IOW, I believe this edit makes the docs worse rather than better. Raymond
Le 03/06/2011 19:43, Raymond Hettinger a écrit :
I think the users are better served by links to collections.abc, io.abc, etc.
The specific problem I addressed was that :ref:`abstract-base-classes` was replaced by “Collections Abstract Base Classes”, which was wrong: the glossary entry talks about “Abstract Base Classes”. I will add links to abc submodules as you suggested tomorrow. Thanks for the review.
participants (2)
-
Raymond Hettinger -
Éric Araujo