Dangling class-level javadoc comments in JDK
Alan Bateman
Alan.Bateman at oracle.com
Tue Aug 24 10:42:59 UTC 2021
On 24/08/2021 07:50, Andrey Turbanov wrote:
> Hello.
> I found a few internal classes in the JDK codebase which don't have
> proper javadoc, but have dangling javadoc-like comments.
> Dangling Javadoc comments are ignored by the javadoc tool and IDE.
> Perhaps it was intentional to not add proper javadoc to them?
> I believe it's better to convert them to proper javadoc to make
> developing JDK a bit more friendly within IDE.
> What do you think?
There isn't any requirement for internal classes to have complete
javadoc. If there are cases in the list where fleshing out or fixing
javadoc issues would help future maintainers then go ahead. Looking at
your list then I assume some of these are just noise and not worth doing
anything.
-Alan
More information about the core-libs-dev
mailing list