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.
Comments
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
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.