Mar 17, 2022
I'm a big fan of summary comments (like the ones used for JavaDoc). Ideally, if you document your public classes and methods, the overall purpose, the arguments and their purpose and the return type, then no one has to go in and read your code to see what it's doing. Otherwise, I think comments should be kept to a minimum and only explain why...not what.