First, you shouldn't hide information about corner cases and weird behavior in test cases. Do you read through test cases every time you use a new function? Nei

First, you shouldn't hide information about corner cases and weird behavior in test cases. Do you read through test cases every time you use a new function? Neither does anyone else. Comment-less code is not a virtue. Useful comments that describe the "why" (but not the "what" or "how") of code are a virtue.