Re: [jakartaee-spec-project-leads] [ee4j-pmc] Preparing for Jakarta EE 8

[Bill Shannon <bill.shannon@xxxxxxxxxx>]

Raymond Auge wrote on 7/15/19 1:16 PM:

On Mon, Jul 15, 2019 at 3:54 PM Bill Shannon <bill.shannon@xxxxxxxxxx> wrote:

The reason the spec name was included is because when all the javadocs are combined to form the platform javadocs, it's much less clear what spec "1.1" refers to.

Could this not be solved by including spec name & version on packages such that it gets included in the javadocs?

I'm not sure I understand what you're suggesting, but the goal was to make the @since clear when looking at an individual API, without having to track back to figure out what package the API is in and what spec that package is a part of.