[issue45922] Many method, function, built-in... are not clickable and should be

Serhiy Storchaka report at bugs.python.org
Mon Nov 29 03:41:27 EST 2021


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

It is a good idea in general. Please go ahead, I am sure that the PR will be accepted.

But keep in mind that not always additional links make the documentation better. The rule of tumb is to not add multiple links to the same entity in one paragraph. In many cases the second and the following references are made non-links intentionally. There is also not much benefit of making a link to itself (if the single-paragraph description of the function contains a reference to that function).

----------
nosy: +serhiy.storchaka

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue45922>
_______________________________________


More information about the Python-bugs-list mailing list