On Mon, 15 Nov 2021 11:25:09 GMT, Hannes Wallnöfer <hann...@openjdk.org> wrote:
> This is a simple change to display the first sentence of the service type > description in the "Provides" section of a module page if the `@provides` > javadoc tag does not contain a description. This is the same we handle > entries in the "Uses" section when no description is available from the > `@uses` tag. The rationale is that it is still more useful to provide generic > information about the service type than nothing if no provider-specific > information is available. Looks good. I was not familiar with this part of JavaDoc. When comparing source and documentation of the JDK, I was somewhat surprised to discover that aside from tests, neither `@uses` nor `@provides` specifies the optional description. ------------- Marked as reviewed by prappo (Reviewer). PR: https://git.openjdk.java.net/jdk/pull/6387
