On: I've never seen a language's style guide recommend...

[mike_hearn]

Right, also, it doesn't actually say avoid comments, it just gives examples of where it's best to try and find an alternative.

In the bitcoinj code style guide there is a big section on comments that gives positive examples as well as negative examples:

http://bitcoinj.github.io/coding-conventions