A decent linter checks those Boolean comments for accuracy. Writing documentation that that merely copies existing code is terrible: it's either going to be wr

A decent linter checks those Boolean comments for accuracy. Writing documentation that that merely copies existing code is terrible: it's either going to be wrong (because it's not automatically checked and will go sour in a refactoring, or it's right because it's so obvious that no one will guess wrong when looking at it.)