The original point was that
auto-generated documentation comments contain nothing that isn't already there in the public interface. Since it tends to look like
/**
* Foos the bar.
*
* @param bar The bar.
*/
public void fooBar(Bar bar) { ... }
The problem with this kind is that the compiler can no longer warn about a missing documentation comment because from its side all looks nice and well – except that there is
zero information in that documentation.
My boss once did that to our entire codebase, adding auto-generated doc comments where there weren't any. Sure, my warning count reached a new low, but documentation quality suffered for months.
