Re: [ee4j-pmc] [jakarta.ee-steering] Recommended approach for creation o

["Kevin Sutter" <sutter@xxxxxxxxxx>]

Hi Will and Bill,
Per our discussion
on the call today, here's the PR that I referenced:  https://github.com/bshannon/spec-template/pull/1

Maybe Bill already
got notified of the PR, but just in case...  I'm just suggesting some
updates to separate the front matter from the license from the spec content.
 I also suggested a naming convention for the generated docs to include
the version identifier.  Hope it helps.

---------------------------------------------------
Kevin Sutter 
STSM, MicroProfile and Jakarta EE architect
e-mail:  sutter@xxxxxxxxxx     Twitter:  @kwsutter
phone: tl-553-3620 (office), 507-253-3620 (office)    
LinkedIn: https://www.linkedin.com/in/kevinwsutter



From:
       will.lyons@xxxxxxxxxx
To:
       jakarta.ee-steering@xxxxxxxxxxx
Cc:
       EE4J
PMC Discussions <ee4j-pmc@xxxxxxxxxxx>
Date:
       06/30/2019
12:41 PM
Subject:
       [EXTERNAL]
[jakarta.ee-steering] Recommended approach for creation of    
   boilerplate specifications.
Sent
by:        jakarta.ee-steering-bounces@xxxxxxxxxxx

---

Hello -

At the last Jakarta EE Steering Committee Meeting we discussed the 
following "Recommended approach for creation of boilerplate specifications":

https://docs.google.com/document/d/1EGSnr8mmNKIp3eb7odz6jpOoc3qwTISO3uzFMuvf5wc/edit?ts=5d122bdd

There was general consensus on the recommended approach. It was 
requested that the doc provide up-front context that we expect to have
copyright clearance for text for a Platform Specification, but will not
have copyright clearance for many of the component specifications.

I have updated the doc the provide the up-front context as requested 
and, as discussed am forwarding for +1 approval as a Steering Committee
recommendation in email.

Oracle votes +1.

Ccing PMC.  Even before this is approved by Steering Committee as
a 
formal recommendation, any project team can (and should IMO) proceed 
with creating component specs using this approach.

Thanks

Will

_______________________________________________
jakarta.ee-steering mailing list
jakarta.ee-steering@xxxxxxxxxxx
To change your delivery options, retrieve your password, or unsubscribe
from this list, visit
https://www.eclipse.org/mailman/listinfo/jakarta.ee-steering