Re: [jakarta.ee-spec.committee] Jakarta EE specification template

[Bill Shannon <bill.shannon@xxxxxxxxxx>]

Ed Bratt wrote on 6/5/19 4:40 PM:
> Bill, this looks quite useful. I think these, along with some minimum
> descriptive content from the particular Spec, will comprise the
> minimum-bar/starting point for all specification documents that will make up
> Jakarta EE 8. That content will start with the approved project name and the
> scope statements.
> 
> I think the rest of this is for the committee and our Mentor (Wayne, I think):
> 
> Is there a process for approving this? If so, what is that process? I don't
> think this is a new project proposal, since it is just proposed as a new
> repository in the Eclipse Jakarta EE Platform project. Maybe this is purely a
> Platform Specification Project question?

I could've proposed this as a new repo as part of the platform project,
and I can still do that if there's enough interest.  I was hoping to get
some feedback to determine if this was worth my time first.  (I just so
love the CQ process!)

> Presuming this template gets approved, should we use this to kick-start all
> projects? Just for those which we don't have Spec. content available immediately
> following the conversion / restructuring review? OR should we create a later
> deadline, after which, we generate a boilerplate (using this template, for the
> express purpose of having a Spec. document to put on ballot.)?
> 
> For those projects that start with this, does anyone have thoughts about how we
> might then integrate or weave in the contributed specifications? (Wholesale
> replacement? Or, would we want to suggest something else?)

Since the contributed specs use roughly the same structure as this template,
switching from a boilerplate spec using this template to a full spec using the
contributed content shouldn't be difficult.  But, all of the contributed spec
documents are going to require significant work to convert the content into
Jakarta EE 8 content.

> I can't assess how many projects might wind up relying on a boilerplate initial
> Spec.

Wayne suggested that maybe 10 specs would be ready for EE 8, so 30-ish
specs would need a boilerplate spec.  Hopefully all the project leads
for those spec projects will create those boilerplate specs quickly.