users@javaee-security-spec.java.net

[javaee-security-spec users] Re: [jsr375-experts] Re: JSR 375 EDR1 Review - Initial comments

From: Bill Shannon <bill.shannon_at_oracle.com>
Date: Mon, 3 Apr 2017 17:06:24 -0700

arjan tijms wrote on 04/ 1/17 07:25 AM:
>
> b) The HttpMessageContext description is missing in the doc.
>
>
> The main description is in the JavaDoc, which is part of the spec regardless
> of what's in the spec document. I'm not 100% sure when something is
> sufficiently spec'ed when in the JavaDoc and when it actually must be in the
> spec document as well.
>
As you say, the javadocs are part of the spec. They're additive. Nothing needs
to be in both. Obviously information that appears in both needs to be consistent.