[issue15580] fix True/False/None reST markup

Chris Jerdonek report at bugs.python.org
Wed Aug 8 08:14:49 CEST 2012


Chris Jerdonek added the comment:

Yes, I can see the trade off.  However, is there a sense in which the situation for documentation could be different from the situation for code?

With code, style and refactoring changes cause churn without directly benefiting the end user (because code is just a means and not the end).  We can hold off on refactoring without impacting the end user.

With documentation though, these are visible, albeit small changes that will directly improve the user's experience.  We would be holding off on improving the pages for the sake of internal churn.  (If it was refactoring reST in a way that didn't change the HTML output, it would be a different story.)

----------

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


More information about the Python-bugs-list mailing list