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 <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