sample javadoc output for records and sealed types.

Brian Goetz brian.goetz at oracle.com
Fri Oct 11 14:11:34 UTC 2019


> On records, what you did looks, again, very clean. The only comment I have there is that it "feels" like something is missing in the summary section... e.g. for some reason I would expect a "record components summary" there. I noted that you lifted the components to the toplevel doc, but I wondering if that's the right move.
> 
> 

There is a “record components” summary, but it is easy to miss — I missed it on first read too.  It is in the top section.  I think it might go better if it were right below the “public record Foo” signature, where the class doc is?  

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.java.net/pipermail/amber-spec-experts/attachments/20191011/6c6d5cc0/attachment.html>


More information about the amber-spec-experts mailing list