[jakartaee-spec-project-leads] Jakarta EE 8 Tasks - update

[Joakim Erdfelt <joakim.erdfelt@xxxxxxxxx>]

I just came off an information dense conversation with David Blevins about the tasks for the Jakarta EE 8 push as they stand today.

The results (for the websocket project) can be found at https://github.com/eclipse-ee4j/websocket-api/issues/295#issuecomment-517743004

Copied here in case others could benefit from this, and hopefully get the conversation on the tasks more aligned for other Jakarta projects that might be in the same boat.

Especially considering the 2 required changes (for all projects) introduced this week regarding javadoc copyright updates and /spec/ efsl copyright header updates

Restage Tasks:

•  Dropping staged 1.1.2 release from oss.sonatype.org
•  Dropping release 1.1.2 from github
•  Dropping tag 1.1.2 from github
•  Dropping branch 1.1.2 from github
•  Opening PR for fixed javadoc bottom tag on EE4J_8 branch
•  Kicking of new 1.1.2 staged release based on EE4J_8 branch
•  Closing new 1.1.2 staged repository on oss.sonatype.org
•  Verifying new 1.1.2 staged repository contents on oss.sonatype.org (manually)
•  Announce new 1.1.2 stage on this issue

As a spec lead I must do these tasks:

•  Verify websocket-tck-1.1.0.zip satisfies TCK requirements at https://github.com/jakartaee/specification-committee/blob/master/process.adoc#materials-for-a-tck-release
•  Build new TCK integration with new 1.1.2 staged websocket API jar at https://jenkins.eclipse.org/websocket/job/TCK_GF_integration
•  Kicking off new websocket TCK run from https://jenkins.eclipse.org/websocket/job/TCK_run to verify the API jar (these results cannot be used for certification as they use a modified impl zip)
•  Update /spec/src/main/asciidoc/license-efsl.adoc for new copyright headers.
•  Build /spec/ tree (the boilerplate spec) - ensure versions are NOT SNAPSHOT / NOT DRAFT.
•  Open new PR at https://github.com/jakartaee/specifications under "Specification PR template" for: - example at jakartaee/specifications#63
  • /websocket/_index.md - general index - see jakartaee/specifications#63
  • /websocket/1.1/_index.md - version specific index
  • /websocket/1.1/websocket-spec-1.1.pdf
  • /websocket/1.1/websocket-spec-1.1.html
•  Open new PR at https://github.com/jakartaee/specifications under "Specification PR template" for /websocket/1.1/apidocs/
•  Open new PR at https://github.com/eclipse-ee4j/jakartaee-api to update the <websocket.version> of the root /pom.xml to 1.1.2

As a compatible implementation I must do these tasks:

•  Ensure I am testing with a completely unmodified implementation zip (NOT the TCK_GF_integration created zip)
•  Kicking off new websocket TCK run from https://jenkins.eclipse.org/websocket/job/TCK_run
•  Submit TCK websocket-tck-1.1.0-summary.txt as a PR to https://github.com/eclipse-ee4j/glassfish - versioned with glassfish
•  Compatible Implementation Certification Request PR on with the specification project (to be used / referenced later in "Specification PR Template") - see example at eclipse-ee4j/injection-spec#3
•  Notify the spec project of the URL of the certification request so someone can update the Specification PR

Optional / Recommended:

•  Unpacking new 1.1.2 apidocs to gh-pages branch in /docs/api/1.1.2/ directory
•  Copy generated spec boilerplate pdf to gh-pages branch in this github repository /docs/spec/1.1.2/ directory
•  Copy generated spec boilerplate html to gh-pages branch in this github repository /docs/spec/1.1.2/ directory