[issue27036] Mark up of references in different form

Serhiy Storchaka report at bugs.python.org
Tue May 17 03:13:32 EDT 2016


Serhiy Storchaka added the comment:

I think you make an accent on wrong thing. All these sentences look correct to me if remove any hyperlinks. Hyperlinks are optional. In the phrase "Level values are evaluated" the reference is to the term "evaluating", not to the eval() function. But since this term is not in glossary and is explained only in eval() description, the reference points to the eval() function. The same is for "weakly referencable" and "joining". It would be more correct ton add explicit labels "evaluating", "weak reference" and "join" and use they in references (":ref:`evaluated <evaluating>`"). This would create links without changing the style of the text.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue27036>
_______________________________________


More information about the Python-bugs-list mailing list