R. David Murray <rdmur...@bitdance.com> added the comment:

This is a common pattern in our documentation.  It is done because ":mod:`xxx`" 
means that xxx should be formatted as a module name, rather than anything else. 
 While it is true that the formatting for most such references is currently the 
same, it could be different in principle, and is for a few.  It is in some ways 
unfortunate that it also always results in a link, so you will indeed find a 
number of places where the prefix is omitted, mostly commonly when the same 
entity is referenced several times in the same paragraph.

So, it is not completely clear cut, but I would recommend rejecting this and 
leaving the docs as is.

----------
nosy: +r.david.murray

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue32774>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to