Useless default documentation dilutes both code and actual documentation
IDEs can create default code, including default documentation, such as:
/** * Insert class or interface description here. */
It would be great if people would actually write documentation. Even a single sentence to describe what the class is modeling would be helpful if it's not obvious from the name. Or object invariants (e.g.
boughtCount <= offeredCount).
To find a class without documentation is annoying. But to see such an IDE-generated phrase is a slap in the face!