Comment by dskrvk

But comments go out of date, and the compiler doesn’t check them against the implementation. To document + enforce the intended functionality, use tests.