[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
|
Re: [jakarta.ee-spec.committee] proposed update to Operations Guide
|
The details of that section are dealing with the release requirements.
This is already more fully spelled out in the "Creating a Final
Specification" section. The details in the voting section should be
removed and detail sections for the various reviews added.
On Thu, Jan 9, 2020 at 8:31 AM Kevin Sutter <sutter@xxxxxxxxxx> wrote:
>
> Hi,
> As I was trying to create a template for the process for our Specification Projects' issues, I found that our Operations Guide is a little confusing when it comes to Voting...
> https://github.com/jakartaee/specification-committee/blob/master/operations.adoc#specification-committee-votes
>
> I think this section is trying to cram too much information into a single section. With Jakarta EE 8, we really only did one formal vote and that was at the end of the release (for each component). But, our process calls for multiple votes during the development process...
>
> Creation Review: 7 calendar days;
> Plan Review: 7 calendar days;
> Progress Review: 14 calendar days;
> Release Review: 14 calendar days;
> Service Release Review: 14 calendar days; and
> JESP Update: 7 calendar days.
>
>
> For example, the current section talks about creating the PRs for the Specs and Apidocs, but those are really only required for the Release Review. And, the referenced Eclipse Release Records are only required for the Plan Reviews.
>
> One easy action would be to update this section and clarify which artifacts (release records, PRs, etc) are required for which Reviews. But, I think that would just complicate this section even further.
>
> My suggestion is that we clean up this section and only talk about the Ballot process in general. And, then create another section that describes the required artifacts for each Review -- but reference the Handbook as the base. We would only need to describe the "above and beyond" requirements for Jakarta EE.
>
> Before I start hacking away, I thought I would get some feedback. Thanks.
>
> ---------------------------------------------------
> Kevin Sutter
> STSM, MicroProfile and Jakarta EE architect @ IBM
> e-mail: sutter@xxxxxxxxxx Twitter: @kwsutter
> phone: tl-553-3620 (office), 507-253-3620 (office)
> LinkedIn: https://www.linkedin.com/in/kevinwsutter
> _______________________________________________
> jakarta.ee-spec.committee mailing list
> jakarta.ee-spec.committee@xxxxxxxxxxx
> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
> https://www.eclipse.org/mailman/listinfo/jakarta.ee-spec.committee
