> Tests can then also serve as a kind of documentation. They would have to be written with documentation in mind, which distracts them from their primary purpo

> Tests can then also serve as a kind of documentation. They would have to be written with documentation in mind, which distracts them from their primary purpose: catching bugs. Trying to understand Monocypher from just its test suite¹ for instance would be a pretty bad idea. That test suite is top notch at catching bugs, but it sucks big time at documenting Monocypher. https://github.com/LoupVaillant/Monocypher/blob/master/tests/test.c https://github.com/LoupVaillant/Monocypher/blob/master/tests...