On: Writing system software: code comments

[detaro]

How do you tie the test suite to the specification? A test for a certain behavior alone doesn't document why it's testing that.

[crdoconnor → detaro]

I have a property on my specification tests called "about" that explains why the feature exists along with other contextual information.

It makes much more sense to centralize the "why does this behaviour exist" there where the specific behaviour is being tested rather than in the code.