Re:Writing system software: code comments
by roblabla on Sunday October 07, 2018 @11:48AM
(#18161134)
The code explains how. The comments explains why. Why does this function have to take that lock? Why is that algorithm chosen? What invariants are required to be upheld (which is a form of "why?").
Good code comments are important. Good unit tests are important too. But both are necessary.
Good code comments are important. Good unit tests are important too. But both are necessary.