3 ms·
I really appreciated this taxonomy! It lines up with my own experience; but I've never thought about it this thoroughly. One specific type of comment that I've
by therealdrag0 8y ago
I really appreciated this taxonomy! It lines up with my own experience; but I've never thought about it this thoroughly.
One specific type of comment that I've found valuable is a sort of BDD in my tests.
testMethod() {
// GIVEN a <specific type of thing>
<setup code>
// WHEN the <specific operation is done>
<do the thing code>
// EXPECT <specific effect>
<assertion code for the effect>
}
These are like "guide comments" but with more structure. I find that they help write tests and also make reading tests transparent.