I think comments should be used much less than we have propagated for years. First, idiomatic code often doesn't need any comments at all. Second, every project

I think comments should be used much less than we have propagated for years. First, idiomatic code often doesn't need any comments at all. Second, every project requires some level of documentation, but the documentation should be a high-level abstraction of the code. So the documentation is the easy way for humans to understand what is going on and when I want to know the details, I can jump into the code. And just if the code itself is so complicated or its implications are not easy to understand (which should rarely be the case), then comments should be used. However, the problem with this mantra is, that the original authors often don't know/want to know when their code is not simple enough ;-)