3 ms·
And then who or what documents the tests? Test code is code. That's important and all too often that fact is sort of elided. "We" write comments and use "plain
by sidlls 10y ago
And then who or what documents the tests? Test code is code. That's important and all too often that fact is sort of elided.
"We" write comments and use "plain" language documentation, or formatted but otherwise plain language for documentation generators to parse to document our code, and that includes "what the code does."
I'd argue that if your test code is what you're relying on to "document what the code does" then you are probably (almost certainly) over-testing, testing the wrong things, or some combination. Oh, and also using test code incorrectly (as documentation).