Write a JSR |
Submit a JSR |
JSR Review |
EG formation |
Early Draft Review |
Public Review |
Proposed Final Draft |
Final Ballot |
Spec Lead Guide
After you have incorporated any changes you decided to make after the public has reviewed your PFD and you've completed the work on the RI and TCK, you are ready to go final Release. You need to submit the Final materials to the PMO (email@example.com) to put on the EC Final Approval Ballot. As with JSR Approval Ballot the PMO must receive all the materials of your submission on or before the Wednesday before the Tuesday that you wish the Ballot to start. The Final Approval Ballot runs for a 1 week voting period starting on Tuesday and ending on Monday, midnight PST/PDT. Once again it is good practice to get a sense of the voting EC's opinion on what you consider to be the Final version of your JSR. It is necessary that you are available during the voting period or you designate someone that will be able to respond any questions the voting EC may have.
When submitting the Final materials to the PMO at firstname.lastname@example.org, please provide all of the following:
For your convenience, we have provided a simple questionnaire to use as a quick reference/checklist when preparing your materials for submission.
- Confirmation that the Expert Group agrees that the JSR is ready to go to Final Release.
- The Final Spec, in pdf or zip format (please note that Javadoc files must be zipped). This will be posted first for the Executive Committee's review in the Final Approval Ballot, then for the community in the Final Release when and if the ballot is approved.
- The answers to the following export questions, supplied separately for each file bundle you wish posted. For instance, if you provide both a specification .pdf document and a .zip archive of javadocs, you would provide two sets of answers to these questions.
Name of the file:
A. Does the specification include software codes
in the following format:
Binary : Yes _______ No __________
Source (compilable) : Yes _______ No __________
Javadocs : Yes _______ No __________
B. Do the codes or the spec call on, contain, use
or demonstrate encryption technology?
Yes _________ No ________
If yes, please describe in detail
- The Final Reference Implementation, in .zip format. This will be posted for the Executive Committee's review in the Final Approval Ballot.
- Confirmation that the Reference Implementation passes the Technology Compatibility Kit.
- The Final Technology Compatibility Kit, in .zip format. This will be posted for the Executive Committee's review in the Final Approval Ballot.
- The version number of your spec and the full legal name of your company or organization for the specification license. The PMO hosts the Final Approval Ballot for you, and uses Oracle's general Final Release license unless you provide your own Final license.
- Any last updates to the checklist for transparency, with specifics for your JSR. If you haven't provided your transparency checklist before, make sure to include the whole thing now.
- The TCK Coverage Document. This is a one- to two-page summary to assist the EC in evaluating the TCK. Please see more details in the 'Developing TCKs' section of the Spec Lead Guide.
- The full text of the final licenses for the RI and TCK (and the specification, if you are not using the standard license). 3rd party implementations must be able to pass the TCK. Please look in the "Writing a JSR" section above for licensing templates. You can use one of these templates or any other licensing model provided the compatibility requirements as demanded in the appropriate JCP Document are addressed. The latest version is found at: http://jcp.org/en/procedures/jcp2. Every JCP version from 2.6 onward requires that final licenses must allow for independent implementations.
- The process by which qualified individuals, educational and not for profit organizations can access the TCK at no cost.
- The process for making first-level appeals to the tests of the TCK.
- The URL where you will make the Reference Implementation available at Final Release.
- The URL where you will make the Technology Compatibility Kit available at Final Release.
- The name and contact info of the Maintenance Lead. In case the Maintenance Lead is a different company or organization the PMO requires an authorization from an Executive of the current Spec Lead company or organization relinquishing interest in the JSR. The same applies for a Spec Lead change earlier in the JSR process.
- The first level TCK Appeals Process, per JCP Document section 3.2.2., which handles challenges to the tests in the TCK.
- An answer to the question: Can the Specification be implemented independently of the Reference Implementation?
- An answer to the question: Do you expect to develop the Specification further through Maintenance Releases or a follow-on JSR?
Assuming the Final Approval Ballot is successful, the PMO will take your answers and work to publish your Final Release from those materials soon thereafter (see "Turnaround time", below). When the Final Release is posted, your Expert Group officially disbands, its work complete.
If the ballot does not succeed, you have 30 days to consider the EC comments, revise your materials, and resubmit them for a Final Reconsideration Ballot. These are conducted the same as the initial Final Approval Ballot. If you plan on submitting materials for Final Reconsideration Ballot, please notify the PMO via email@example.com as soon as possible. If the initial Final Approval Ballot fails and you do not submit for Final Reconsideration Ballot within 30 days or you do submit and the Final Reconsideration Ballot is also voted down by the EC, the JSR is marked as Rejected and the Expert Group disbands.
If the Final Reconsideration Ballot is approved by the EC, you may proceed to submitting the materials for Final Release normally. Please notify the PMO at your earliest convenience when you will submit the materials for Final Release.
Turnaround time: With any public posting of a spec to jcp.org, the PMO will post the spec and related materials within 10 business days of receiving ALL the materials at firstname.lastname@example.org. You may check the status of your Final Approval Ballot or Final Release submissions on the JCP JIRA page, where issues are filed for each JSR milestone submission.
The PMO welcomes suggestions and requests from the Spec Leads for improvements of this guide and the process: email@example.com