News for hackers. Stuff that matters.
Re:The Code Documentation Fallacy by baddox on Thursday October 17, 2013 @08:21PM (#6569063)
> Complaining that API documentation gets out of sync with the code is like complaining that unit tests break when you change the code.

But that can be a valid complaint as well. There is an undeniable cost of maintaining tests, and it shouldn't just be taken for granted that the cost is worth it.

Re:The Code Documentation Fallacy by einhverfr on Friday October 18, 2013 @05:47AM (#6570521)
In both cases, you shouldn't be documenting and testing the internals if your functions, but the code contract, i.e. that it does what you have agreed with other developers that the function will do.

The question is not whether to test or whether to document, but what to test and what to document.