[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