I agree with essentially everything that you said. The one thing that I'll add is that I was speaking specifically of Test Driven Development, not of tests in g

I agree with essentially everything that you said. The one thing that I'll add is that I was speaking specifically of Test Driven Development, not of tests in general. The benefits of using tests as documentation come regardless of religious adherence to test-first, and in my opinion are often hindered by it. I agree that tests can make great documentation, as well as adding value for a number of other reasons (regression, etc). I severely question the concept of writing them first in all (or even most) cases, though.