Skip to main content
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [websocket-dev] Final specification PR review
Great. I did a scan through the documents. Seems like the TCK material isn't updated yet. Anyway, hopefully I've provided enough pointers to quickly attend to anything that still needs updates. 

Great progress/work! Thank you.

-- Ed

On 7/19/2020 11:43 AM, Mark Thomas wrote:

Hi Ed,

It is close to being done. I have PRs sat on my local machine for this.
The main hold-up has been getting the release artefacts to build
correctly. Some POM clean-up (my fault) a little while ago created some
issues that didn't appear until we tried to do the release via CI
(primarily due to the non-standard packaging used in WebSocket).

I think we have the build issues fixed now so I hope to get the PRs in
place in the next few hours.

Mark


On 19/07/2020 16:37, Ed Bratt wrote:

Hi,

I've been assigned as a Specification Committee member, to shepherd the
WebSocket final specification through the process necessary to bring it
to final ballot.

Ideally, Web Socket would be included in the first wave of
Specifications for ballot. These were hoped to be ready by the end of
the day, tomorrow, July 20, so they could begin their final review
ballot starting Tuesday July 21 (cf, Jakarta EE 9 release plan
<https://eclipse-ee4j.github.io/jakartaee-platform/jakartaee9/JakartaEE9ReleasePlan>
and Jakarta EE 9 Schedule
<https://eclipse-ee4j.github.io/jakartaee-platform/jakartaee9/JakartaEE9#jakarta-ee-9-schedule>).

Please let me know what the status of this effort is so that I can
assist as necessary and maybe even get this specification ready for
ballot, if not this week, next. I know that you have been doing lots of
work on this specification and I'm hoping it's close to being finished.

If you already know what to do, skip the rest of this message.
Otherwise, to finish this up:

Some pointers to help finish your work preparing the specification for
ballot. For reference, the Web Socket PRs are (Spec
<https://github.com/jakartaee/specifications/pull/79>, API Docs
<https://github.com/jakartaee/specifications/pull/80>).

   * Make sure all the materials are complete and ready to go
       o The Spec document, in FINAL status (HTML and PDF)
       o The JavaDocs
       o The TCK
           + The TCK itself and all the accompanying documentation
           + The TCK is posted in its pre-final download location (e.g.
             download.eclipse.org/ ... /*.zip
       o Evidence that a compatible implementation passes the TCK
           + The TCK result summary (include these data
             <https://github.com/jakartaee/specification-committee/blob/master/compatibility-certification-request.md>;
             Here is an example from 1.1
             <https://eclipse-ee4j.github.io/tyrus/TCK-Results>)
           + Don't forget to file the Compatibility Certification Request
             in the WebSocket API issue tracker (here is the WebSocket
             1.1 cert. request issue
             <https://github.com/eclipse-ee4j/websocket-api/issues/308>)
   * Complete the first five steps outlined in the Specification
     Finalization Checklist
     <https://github.com/jakartaee/specification-committee/blob/master/spec_finalization_checklist.md>.
     Note that it is optional to create a single PR for both the
     Specification material and the JavaDoc -- or create two PRs. For
     review, two may be easier to manage but it's up to you.
   * I will verify all the material is completed using this committee
     written Spec. Review Checklist
     <https://github.com/jakartaee/specification-committee/blob/master/spec_review_checklist.md>.
     You or I can just paste this into the PR so we can keep track of any
     omissions.

Open a pull request against the jakartaee/specifications
<https://github.com/jakartaee/specifications/pulls> GitHub Repository.
You can also just look for examples with the "waveN"  labels if you want
to see any current examples. The PR will be created with a checklist
(from this template
<https://github.com/jakartaee/specifications/blob/master/pull_request_template.md>).

If there is anything I can help with, please let me know. Thank you for
the work you've done so far. I really appreciate it.

-- Ed Bratt

P.S. A detailed guide to creating a Jakarta EE Specification is in The
Jakarta EE Operations Guide
<https://jakarta.ee/committees/specification/operations/>, look under
the section heading: Creating a Final Specification.

_______________________________________________
websocket-dev mailing list
websocket-dev@xxxxxxxxxxx
To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/websocket-dev


_______________________________________________
websocket-dev mailing list
websocket-dev@xxxxxxxxxxx
To unsubscribe from this list, visit https://www.eclipse.org/mailman/listinfo/websocket-dev

Back to the top