On Mon, Oct 8, 2018 at 4:26 PM Marko Ristin-Kaufmann <marko.ris...@gmail.com> wrote: >> Not true for good docstrings. We very seldom change the essential >> meaning of public functions. > > In my team, we have a stale docstring once every two weeks or even more > often. If it weren't for doctests and contracts, I could imagine we would > have them even more often :) >
In other words, you change the *public interface* of your functions all the time? How do you not have massive breakage all the time? ChrisA _______________________________________________ Python-ideas mailing list Python-ideas@python.org https://mail.python.org/mailman/listinfo/python-ideas Code of Conduct: http://python.org/psf/codeofconduct/