sample javadoc output for records and sealed types.

Maurizio Cimadamore maurizio.cimadamore at oracle.com
Fri Oct 11 16:01:05 UTC 2019


On 11/10/2019 15:11, Brian Goetz wrote:
>>
>> 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?
>
I didn't "miss" it - I noted that - but then longed for more :-)

Maurizio



More information about the amber-spec-experts mailing list