You are right about commenting tests, but it seems wrong to categorically reject their value as documentation for users. I use tests all the time to get code ex

You are right about commenting tests, but it seems wrong to categorically reject their value as documentation for users. I use tests all the time to get code examples and understand what's actually supported. One of the great things about open source projects is that you can see the tests.