Sept. 22, 2013
11:19 p.m.
On Sun, Sep 22, 2013 at 2:41 PM, Xavier Morel <python-dev@masklinn.net>wrote:
The points here are that there's a single source of truth (so we can't have conflicting docstring and rst documentation), and documentation becoming outdated can be noticed from both docstring and published documentation.
Another case of DRY madness. It seems too many programmers see documentation as unpleasant red tape they want to cut through as quickly as possible, instead of an opportunity to communicate with their *users*. To the contrary: users should be the most important people in the world if you're writing code that's worth documenting at all. -- --Guido van Rossum (python.org/~guido)