R. David Murray added the comment:

I prefer to have some of them be links and some of them be code markup.  That 
is, I think there is value in having some of them be links.  As Georg said, the 
devguide rule is more about it not being *necessary* to waste time marking them 
*all* up as constants.  Having some of them marked up as constants will be 
enough to lead a newbie to the documentation for them.

When writing new docs, I will typically mark them up as constants once or twice 
in the new docs, and make the remainder code markup.

----------

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

Reply via email to