| [jakarta.ee-spec.committee] Review for approval: Jakarta EE Specification Committee Meeting Minutes October 28th, 2020 |
Attendees (present in bold):
Kenji Kazumura - Fujitsu
Dan Bandera - IBM - Kevin Sutter, Tom Watson (guest)
Ed Bratt - Oracle - Dmitry Kornilov, Lukas Jungmann
Andrew Pielage - Payara - Matt Gill
Scott Stark - Red Hat - Mark Little, Scott Marlow, Tom Jenkinson
David Blevins - Tomitribe - Jean-Louis Monteiro, Cesar Hernandez
Ivar Grimstad - PMC Representative
Marcelo Ancelmo - Participant Member - Martijn Verburg
Werner Keil - Committer Member
Scott (Congquan) Wang - Primeton - Enterprise Member
Eclipse Foundation: Tanja Obradovic, Paul Buck
Past business / action items:
Approval is requested for the meeting minutes from the October 14th meeting as drafted - Approved.
Approval is requested for the meeting minutes from the October 21st meeting as drafted - Approved.
Agenda:
Jakarta EE 9 Specification ballot tracking spreadsheet: https://docs.google.com/spreadsheets/d/1YTUpfdLZZrk2_UGwoX2w0seOCulseRO3sQJIjWxpDAa7g/edit#gid=0
Short description missing on https://jakarta.ee/specifications/ [Tanja]
What needs to be done to ensure a short (60 char) description is available and presented for each specification project?
This is also needed for jakarta.ee Chinese translation
Notes:
Are we still in agreement with providing the 60 char description: Yes
Create tickets on GitHub to create requests to the spec projects to create their
descriptions. Note the change needs to be made to the spec repo.
Default is first 57 char + “…” if no 60 char description tag is present.
Scott S to create PR to get the default in place for projects
References to legacy Java EE specifications? Are these allowed? What about license issues? [Ed]
Be factual and where possible use the Jakarta edition of specifications naming conventions and where possible rewrite to avoid reference or avoid reference to a doc with a click-through license
Specific guidance is required and needs to be written up.
Ed create an issue
Discussion topic - Helping spec authors [All]
Best practice to convert the diagrams in the heritage Java EE docs - PNG → SVG.
https://www.eclipse.org/lists/jakartaee-platform-dev/msg01884.html
https://github.com/eclipse-ee4j/jakartaee-platform/issues/214
What tools do we recommend for creating, editing, updating images?
https://inkscape.org/ was used for some diagrams in the Platform spec
Do we need a repo for spec projects to share best practices, scripts, …
Spec Lead Guide from the JCP could be an example of what help to provide?