On Thu, Jul 7, 2011 at 7:18 AM, Grant Edwards <invalid@invalid.invalid> wrote: > On 2011-07-06, Waldek M. <wm@localhost.localdomain> wrote: >> Dnia Wed, 06 Jul 2011 03:36:24 +1000, Steven D'Aprano napisa?(a): > >>> Because unless you are extremely disciplined, code and the comments >>> describing them get out of sync. [...] > >> True, but that gets far worse with external docs. Do you have in mind >> any better replacement? > > You write code that's easy to read
Reminded me of this excellent presentation: "Uncomment Your Code" https://docs.google.com/present/view?id=ah82mvnssv5d_162dbgx78gw Cheers, Chris -- http://mail.python.org/mailman/listinfo/python-list