JCP 2.10: Process Document
The formal procedures for using the Java Specification development process. Read the .pdf file here. This process was developed via JSR 364, and also includes new types of JCP Membership. Read the JCP Participation Overview page for more information.
Version 2.10.2 (October 16 2017)
3.1.2 Partner Member
3.1.3 Associate Member
3.1.4 Full Member
3.1.5 Member Representative
3.1.6 Membership Fees
3.2.1 Expert Group transparency and participation
3.2.2 Expert Group membership
3.2.3 JSR deadlines
3.2.4 Compatibility testing
3.2.5 Executive Committee duties
3.2.6 PMO response times
3.2.7 Escalation and appeals
3.3.1 Initiate a Java specification request
3.3.2 JSR review
3.3.3 JSR Approval Ballot
3.3.4 Form the Expert Group
3.4.1 Write the first draft of the Specification
3.4.2 Early Draft Review
3.4.3 Updating the draft during Early Draft Review
3.4.4 Public Review
3.4.5 Public Review Ballot
3.5.1 Proposed Final Draft
3.5.2 Complete the RI and TCK
3.5.3 Establish a first-level TCK Appeals Process
3.5.4 Update the deliverables in response to a TCK appeal
3.5.5 Final Approval Ballot
3.5.6 Final Release
3.6.1 Maintenance Lead responsibilities
3.6.2 Maintenance Review
3.6.3 Maintenance Review Ballot
3.6.4 Maintenance Release
3.7.3 EC duties and responsibilities
3.7.4 EC selection process and length of terms
3.7.5 Selection process for Ratified Seats
3.7.6 Selection process for Elected and Associate Seats
3.7.7 JSR ballot rules
The international Java community develops and evolves JavaTM technology specifications using the Java Community Process (JCP.) The JCP produces high-quality specifications using an inclusive, consensus-based approach that produces a Specification, a Reference Implementation (to prove the Specification can be implemented,) and a Technology Compatibility Kit (a suite of tests, tools, and documentation that is used to test implementations for compliance with the Specification.)
Experience has shown that the best way to produce a technology specification is to gather a group of industry experts who have a deep understanding of the technology in question, and for a strong technical lead work with that group to create a first draft. Agreement on the form and content of the draft is then built using an iterative process that allows an ever-widening audience to review and comment on the document.
An Executive Committee (EC) representing a cross-section of both major stakeholders and other members of the Java community is responsible for approving the passage of Specifications through the JCP's various stages and for reconciling discrepancies between Specifications and their associated test suites.
There are four major stages in this version of the JCP:
Appeal Ballot: The EC ballot to override a first-level decision on a TCK test challenge.
Associate Member: An individual who wishes to participate independently in the activities of the JCP without requiring an employer's permission.
Associate Membership Agreement: The membership agreement signed by Associate Members.
Associate Seat: An Executive Committee seat filled by the election process described in section 3.7.6.
Ballot: See Appeal Ballot, Final Approval Ballot, Final Approval Reconsideration Ballot, JSR Approval Ballot, JSR Reconsideration Ballot, JSR Renewal Ballot, JSR Renewal Reconsideration Ballot, JSR Withdrawal Ballot, Maintenance Review Ballot, Maintenance Renewal Ballot, Maintenance Release Withdrawal Ballot, Public Review Ballot, Public Draft Specification Reconsideration Ballot, Transfer Ballot. Unless otherwise noted in this document all Ballots last for 7 days.
Contributor Agreement: A legal agreement defining the terms, particularly those concerning the grant of intellectual property rights, under which contributions are made to a project.
Contributor: A JCP Member who is not a member of an Expert Group but who at the Spec Lead's discretion is formally recognized as having contributed to the JSR.
Dormant Specification (Dormant): A Specification that the PMO has determined has no assigned Specification Lead or Maintenance Lead, or that is not being actively developed and on which no further development is anticipated.
Early Draft Review: A 15 to 90 day period (the length to be set at the discretion of the Spec Lead) during which the public reviews and comments on the draft Specification.
Elected Seat: An EC seat filled by the election process described in section 3.7.6.
Employer Contribution Agreement: An agreement that must be signed by the employer of an individual Full Member in which the employer makes certain IP commitments with respect to the employee's participation in the JCP.
Executive Committee (EC): The Members who guide the evolution of the Java technologies. The EC represents a cross-section of both major stakeholders and other Members of the Java community. EC members are selected in an annual election process. The EC Policies and Procedures are specified in the EC Standing Rules, which is a separate document.
Expert Group (EG): The group of JCP Members who develop or make significant revisions to a Specification.
Final Approval Ballot: The EC ballot to approve the Final Draft along with its associated RI and TCK.
Final Approval Reconsideration Ballot: The EC ballot to reconsider an initial rejection of a Final Draft, RI, and TCK.
Final Draft: The final draft of the Specification that will be put forward for EC approval.
Final Release: The final stage in the JSR development process when the Specification, RI, and TCK have been completed and can be licensed by implementers.
First-Level TCK Appeals Process: The process defined by the Spec Lead that allows implementers of the Specification to appeal one or more tests defined by the Specification's TCK.
Full Member: A corporation, organization, or individual who has signed the JSPA in order to obtain full membership rights within the JCP.
Issue: an explicit reference to an item defined in an Issue Tracker.
Issue List: A list of Issues generated from an Issue Tracker, identifying the disposition of each.
Issue Tracker: A mechanism to allow issues (problems, tasks, comments, or requests for change) to be recorded and tracked by priority, status, owner, or other criteria. The Issue Tracker should permit issues to be identified by states such as open, resolved, and closed and should support the assignment of resolution types such as deferred (postponed to a follow-on release,) fixed (implemented,) challenged (no satisfactory resolution,) and rejected (deemed inappropriate or out of scope.)
Java Community Process (JCP): The formal process described in this document for developing or revising Java technology Specifications.
Java Community Process Member (Member): A company, organization, or individual that has signed a Membership Agreement and is abiding by its terms.
Java Specification (Specification): A written specification for some aspect of the Java technology. This includes the language, virtual machine, Platform Editions, Profiles, and application programming interfaces.
Java Specification Request (JSR): The document submitted to the PMO by one or more Members to propose the development of a new Specification or a significant revision to an existing Specification.
Java Specification Participation Agreement (JSPA): A one-year renewable agreement between Oracle America and a company, organization or individual that allows the latter entities to participate in the Java Community Process as a Full Member.
JCP Website: The website where the public can stay informed about JCP activities, download draft and final Specifications, and follow the progress of Specifications through the JCP.
JSR Approval Ballot: The EC ballot to determine if the initial JSR submission should be approved.
JSR Reconsideration Ballot: The EC ballot to determine if a revision of an initial JSR submission should be approved.
JSR Page: The web page on the JCP Website where the JSR's history is recorded and where other relevant information about the JSR is published.
JSR Renewal Ballot: An EC ballot to confirm that a JSR should continue in its work. JSR Renewal Reconsideration Ballot: An EC ballot to determine if a revised JSR should continue its work.
JSR Review: A 14 to 30 day period (the length to be set at the discretion of the submitter) during which the public can review and comment on a proposed new JSR before the JSR Approval Ballot.
JSR Withdrawal Ballot: An EC ballot to confirm that a completed JSR that appears to have been abandoned should be withdrawn.
Licensor Name Space: The public class or interface declarations whose names begin with "java", "javax", "com.oracle", "com.sun" (or "com.Your name" if You are the Specification Lead) or their equivalents in any subsequent naming convention adopted by Oracle.
Maintenance Lead (ML): The Member Representative or individual JCP Member responsible for maintaining the Specification.
Maintenance Release: The final stage in the JSR maintenance process when the Specification, RI, and TCK have been updated and can be licensed by implementers.
Maintenance Review: A 14 or 30 day period (the length to be set at the discretion of the Maintenance Lead) prior to finalization of a Maintenance Release when Members and the public consider and comment on the changes the Maintenance Lead proposes to include in the release, as identified in the associated Issue List.
Maintenance Review Ballot: An EC ballot to determine whether the changes and time line proposed by a Maintenance Lead are appropriate for a Maintenance Release.
Maintenance Renewal Ballot: a ballot during which EC members vote on whether to permit a Maintenance Lead to extend the deadline for delivery of materials for Maintenance Release, or whether the previous Maintenance Review should be rescinded and the ML be required to start the process again.
Maintenance Release Withdrawal Ballot: An EC ballot to confirm that a completed Maintenance Release that appears to have been abandoned should be withdrawn.
Member: See Associate Member, Full Member, Java Community Process Member, Member Representative, Partner Member.
Member Representative: An individual who is an employee of or who has a contractual relationship with a Full Member and who is authorized by that Member to represent its interests within the JCP.
Membership Agreement: See Associate Membership Agreement, JSPA, Partner Membership Agreement.
Observer: An individual who is not a member of the JCP but who takes advantage of the JCP's transparency mechanisms to observe and/or comment on Expert Group activities.
Partner Member: A non-profit organization that is unwilling or unable (since it is not a legal entity) to sign the JSPA but which nevertheless wishes to promote and to participate in the activities of the JCP.
Partner Membership Agreement: The membership agreement signed by non-profit organizations that are not legal entities, and therefore ineligible to sign the JSPA.
Platform Edition Specification (Platform Edition): A Specification that defines a baseline API set that provides a foundation upon which applications, other APIs, and Profiles can be built. There are currently three Platform Edition Specifications: Java SE, Java EE, and Java ME.
Profile Specification (Profile): A Specification that references one of the Platform Edition Specifications and zero or more other JCP Specifications (that are not already a part of a Platform Edition Specification.) APIs from the referenced Platform Edition must be included according to the referencing rules set out in that Platform Edition Specification. Other referenced Specifications must be referenced in their entirety.
Program Management Office (PMO): The group within Oracle that is responsible for administering the JCP and chairing the EC.
Proposed Final Draft: The version of the draft Specification that will be used as the basis for the RI and TCK.
Public Draft Specification Reconsideration Ballot: The EC ballot to determine if a revised draft should proceed after Public Review.
Public Review: A 14 to 90 day period (the length to be set at the discretion of the Spec Lead) when the public can review and comment on the draft Specification.
Public Review Ballot: The EC ballot to determine if a draft should proceed after Public Review.
Ratified Seat: An EC seat filled by the ratification process described in section 3.7.5.
Reference Implementation (RI): The prototype or "proof of concept" implementation of a Specification.
Release: A Final Release or a Maintenance Release
Specification: See Java Specification.
Specification Lead (Spec Lead): The Member Representative or individual JCP Member who leads an Expert Group and who is responsible for its deliverables as defined in this Process Document.
Technology Compatibility Kit (TCK): The suite of tests, tools, and documentation that is used to determine if an implementation of a JCP complies with the Specification.
Transfer Ballot: The EC ballot to approve transfer of ownership of a Specification, RI, and TCK from one JCP Member to another. (Transfer of ownership does not mean transfer of IP rights, only the right to start again. The new Spec Lead can, however, negotiate a transfer of IP with the old Spec Lead.)
Umbrella Java Specification Request (UJSR): A JSR that defines or revises a Platform Edition or Profile Specification. A UJSR proceeds through the JCP like any other JSR.
The terms "must", "must not", "required", "shall", "shall not", "should", "should not", "recommended", "may" and "optional" are used in this document in accordance with the IETF's RFC 2119.
The use of the term day or days in this document refers to calendar days unless otherwise specified.
3. THE JAVA COMMUNITY PROCESS PROGRAM
In order to enable the broadest possible participation in the work of the JCP several different roles and membership levels have been defined.
Individuals need not sign a formal JCP Membership Agreement in order to observe and comment on Expert Group activities, since they may take advantage of the JCP's transparency mechanisms such as public mailing lists and Issue Trackers. Information on how to provide feedback can be found on the JSR's collaborative project page (a pointer to that page is provided on the JSR page at jcp.org). Observers are not eligible to join Expert Groups, to run for election to the Executive Committee, or to vote in the JCP's annual elections.
3.1.2 Partner Member
Non-profit organizations such as Java User Groups that are unwilling or unable (because they are not legal entities) to sign the JSPA may sign a simplified Partner Membership Agreement that focuses on the promotion of JCP activities in collaboration with JCP Members and the PMO.
Partner Members cannot act as a Spec Lead or serve on most Expert Groups, but they are eligible to run for election to the Executive Committee. If elected, in their role as Executive Committee members, they may serve as members of the Expert Group for JSRs whose focus is redefining the JCP's organization and "constitution" through the process described in Appendix A. Partner Members have the same voting rights as Full Members.
3.1.3 Associate Member
An individual who is unwilling or unable to sign the JSPA may sign an Associate Membership Agreement in order to participate in the activities of the JCP. (Organizations are ineligible for this class of membership.) The Associate Membership Agreement is simpler than the JSPA, and involves only a personal IP commitment. No employer signature is required.
Associate Members cannot act as a Spec Lead, join an Expert Group, or run for election to the Executive Committee. They are eligible to vote for Associate Executive Committee seats but are not eligible to vote for Ratified or Elected Seats. At the Spec Lead’s discretion Associate members can be formally recognized by being listed as Contributors to a JSR.
3.1.4 Full Member
This class of membership is open to corporations, non-profit organizations that are legal entities, self-employed and unemployed individuals, students, and some employed individuals. The JSPA is the membership agreement for Full Members.
Non-employed individuals and university staff are eligible for Full Membership if they are legally able to license their own IP and can therefore sign the JSPA on their own behalf.
Employed individuals are eligible for Full Membership if their employer is willing to sign an Employer Contribution Agreement (no Employer Contribution Agreement is required from university staff). Such individuals should register with their employee email address rather than with a personal email address in order to enable the PMO to track changes in employment status. They should also agree to inform the PMO when they change employers.
Full members may act as a Spec Lead, join an Expert Group, and run for election to any class of seat on the EC. Full members may vote for Ratified and Elected Seats on the EC but not for Associate Seats.
3.1.5 Member Representative
Employees and other individuals who have a contractual relationship with Full Members may be authorized by the Full Member to represent its interests within the JCP by acting as a Spec Lead, serving on an Expert Group, or running for the EC. These Members should register with their employee email address rather than with a personal email address in order to enable the PMO to track changes in employment. They should also agree to inform the PMO when they change employers.
3.1.6 Membership Fees
In anticipation of changes proposed for the next version of the JSPA the PMO commits to waiving membership fees for commercial organizations as it currently does for non-profit organizations. Consequently, under JCP 2.10 there will be no fees for any class of membership.
Each Expert Group is free to use the working style that it finds most productive and appropriate, so long as this is compatible with the requirements specified in this document. For example, an EG may choose to move forward only when there is general agreement among its members, or by voting on issues when there is disagreement.
One useful way to encourage broad participation is to encourage Members (particularly Associate Members) to become Contributors to the JSR. Partner Members such as Java User Groups may be helpful in identifying potential Contributors.
The EG must take into consideration and publicly respond to all significant feedback. EGs must maintain a publicly-accessible document archive from which all of their working materials such as source documents, meeting agendas, minutes, and draft documents can be accessed. The EC should take the Expert Group's transparency record into consideration when voting on its JSR.
The PMO will publish this information on the JSR Page, and will require the EG to provide updated information on the actual progress of the JSR throughout its lifetime. That information will also be published.
When voting to approve a JSR's transition to the next stage EC members should take into consideration the extent to which the Spec Lead is meeting the JCP’s transparency requirements.
Spec Leads should be aware of their obligations to license the output of their JSR and to make certain patent grants on the terms defined in the JSPA. Incorporating feedback provided through public email lists or forums without ensuring that the provider has signed a Membership Agreement or an equivalent Contributor Agreement may make it impossible to meet these requirements or may expose the Spec Lead to legal liability.
The use of Confidential Information (as defined in the JSPA) limits transparency, is strongly discouraged, and will be prohibited in a future version of the Process. If the Spec Lead intends to permit the use of Confidential Information (such as emails, drafts, or submissions marked as Confidential) this must be specified in the initial Java Specification Request.
Expert Groups may choose to keep purely administrative matters private, but all substantive business must be performed in a manner that allows the public to observe their work and to respond to it. All proceedings, discussions, and working documents must be published, and a mechanism must be established to allow the public to provide feedback. One common way of meeting these requirements is through the use of mailing lists, but other alternatives such as blogs, Wikis, and discussion forums may be preferred. Whatever communication mechanisms are chosen, these must include an archiving function so that a record of all communications is preserved. Archives must be readable by the public.
Issues must be tracked through a publicly readable Issue Tracker. The Expert Group may choose to use a publicly writable Issue Tracker, thereby permitting the public to log issues directly, or alternatively to identify formal comments in some other manner and to enter them into the Issue Tracker on behalf of the submitter. Whatever mechanism is used, a publicly-readable audit trail of all comments and Issues must be maintained.
Whenever a Spec Lead or a Maintenance Lead submits materials to the PMO for review or ballot they must also provide an Issue List indicating the disposition of all of the Issues that have been logged against the JSR. Issues logged late in the review cycle may be deferred for later consideration, and Issues that are blatantly off-topic or that appear to have been submitted maliciously or erroneously may be ignored.
In order to enable EC members to judge whether Issues have been adequately addressed, the Issue List must make a clear distinction between Issues that are still open, Issues that have been deferred, and those that are closed, and must indicate the reason for any change of state.
The PMO shall publish the Issue List or a pointer to it together with the other materials.
EC members should review the supplied Issue List and take it into consideration when casting their ballot. If they have any reservations or concerns about a 'yes' vote, or if they wish to vote 'no,' they must accompany their ballot with comments which reference one or more Issues (perhaps logged by them) that they would like to see addressed in the future. EC members should vote 'no' if they believe that the Spec Lead or Maintenance Lead has not adequately addressed all Issues including those that have been rejected or otherwise closed by the Expert Group.
As described in Section 22.214.171.124 below, the proposed licensing terms must be disclosed during JSR submission. The Specification license must not be modified after initial submission since to do so could invalidate IP grants. It may be necessary, however, to modify the proposed RI or TCK license.
Any such changes must be disclosed when the Specification is next submitted to the PMO for public posting or review.
For as long as a JSR is licensed and while it is legally possible to do so the Spec Lead must offer the RI and TCK licenses that were published at the time of Final Release, with the exception that reasonable increases in price are permitted. At subsequent Maintenance Releases alternate RI or TCK licenses may also be offered so long as all changes are disclosed, but licensees must be free to choose the original terms if they wish. For example, existing licensees who do not wish to accept a modified license when required to adopt a newer TCK shall have the option to license the updated TCK under the previous terms. If a JSR changes hands the new Maintenance Lead must present a license with terms comparable to, or more favorable to licensees than the existing license.
When a newer version of a technology is created through a follow-on JSR, the Specification, RI, and TCK license terms for the new JSR may differ from those offered for the previous JSR, but any such changes must be disclosed during JSR submission. The original terms for the previous JSR must be offered for as long as that JSR is licensed.
There is no size limit on the Expert Group. The Spec Lead may add additional members at any time so long as existing EG members are consulted. New members may be added, for example, to increase diversity of opinion.
Any JCP Full Member or Member Representative may request to join an Expert Group at any time by submitting their nomination via the online form provided on the JSR Page.
Details of such requests, including the organizational affiliation of the requester, together with the Spec Lead's official response, substantive deliberations within the EG about the matter, and any other official decisions related to EG membership must be published through the EG's public communication channel.
JCP Members who are not members of the Expert Group may inform the Spec Lead at any time of their interest in contributing to the work of the Expert Group with the possibility of being formally recognized as Contributors.
The PMO will ensure that the JSR Page lists the Members who are members of the EG together with the names of individual Member Representatives where appropriate. At the Spec Lead's discretion Members who are Contributors to the work of the JSR will also be listed together with their Partner Member affiliation where appropriate.
An EG member may withdraw from the Expert Group at any time. If the withdrawing member is the Spec Lead, the Expert Group, with the help of the PMO, should approach the Member who originally contributed the Spec Lead, if any, and request them to provide a suitable replacement; if no such replacement is forthcoming, the Expert Group should choose one of its current members as the new Spec Lead, in which case the PMO must initiate a Transfer Ballot as specified in section 126.96.36.199 of this document. If no replacement can be found, or if the Transfer Ballot fails, then the PMO shall declare the Specification to be Dormant and no further work can be carried out. If the withdrawing member is not the Spec Lead, the Spec Lead should approach the member's organization (if any) to find a suitable replacement.
There may be rare instances when members of the Expert Group feel that one of their fellow members is not acting in ways that advance the work of the Expert Group, and is being disruptive, uncooperative or unresponsive. EG members are expected to make a reasonable effort to resolve any such issues among themselves, with the active help of the Spec Lead. However, if the situation cannot be resolved in a timely manner, any three members of the EG can approach the Spec Lead and request that the EG member in question be excluded from further participation in the EG. If the Spec Lead agrees to the request he can then do so. In the case where the EG member in question is a Member Representative, the Spec Lead must first request that the Member replace its representative. If the Member does not do so in a timely manner, the Spec Lead can exclude the Member itself from further EG participation. The Spec Lead's decision as to whether or not to exclude can be appealed to the EC by following the process outlined in Section 3.2.7, "Escalation and Appeals"
There may be rare instances when members of the Expert Group feel that the Spec Lead is not acting in ways that advance the work of the Expert Group and is being unresponsive or inactive. The EG is expected to make a reasonable effort to resolve any such issues in a timely manner. However, if the situation cannot be resolved these concerns should be brought to the attention of the EC as quickly as possible so they may be proactively addressed and resolved.
If the problems cannot be resolved informally, any three members of the EG may request the EC to replace the Spec Lead. All such requests must clearly state the cause of the concern and provide all necessary evidence. If the EC agrees that there is cause, it may ask the PMO to replace the Spec Lead. If the Spec Lead is a Member Representative the PMO shall ask the Member to replace the Spec Lead. If the Member declines to do so, the PMO shall seek an alternative Spec Lead, in which case the EC must conduct a Transfer Ballot as specified in section 188.8.131.52 of this document. If no Spec Lead replacement can be found, the EC shall initiate a JSR Renewal Ballot to determine whether the JSR should be shut down.
If a Spec Lead or Maintenance Lead decides to discontinue his or her work at any time (including discontinuing maintenance activities or declining to take on the role of Spec Lead during a significant revision initiated by a new JSR) they should, with the assistance of the PMO, make a reasonable effort to locate another Member who is willing to take on the task. If a replacement is identified the PMO must initiate a Transfer Ballot within 30 days to enable EC members to approve the transfer of responsibilities. If the ballot succeeds, the new lead must assume his or her responsibilities within 30 days. In order to facilitate such a transfer of responsibilities the outgoing lead is strongly encouraged to transfer all its Intellectual Property rights in the existing JSR to the new lead.
If no replacement can be found, or if the Transfer Ballot fails, then the PMO shall declare the Specification to be Dormant and no further work can be carried out. No further Transfer Ballots will be initiated by the PMO unless a Member volunteers to take on the lead role, in which case the PMO will again have 30 days to initiate a Transfer Ballot.
If a JSR does not begin Early Draft Review within 9 months of completing its JSR Approval Ballot, or does not begin Public Review within 12 months of first submitting an Early Draft, or does not reach Final Release within 12 months of commencing Public Review, then the EC shall initiate a JSR Renewal Ballot. The PMO shall inform the Spec Lead and Expert Group of this decision and will request the Spec Lead and Expert Group to prepare a public statement to the EC. The JSR Renewal Ballot shall start 30 days after the request. If the JSR Renewal Ballot is approved by the EC, then another renewal ballot cannot be initiated for that JSR for an additional year.
The Spec Lead may also voluntarily request that the JSR be declared Dormant. Under these circumstances a JSR Renewal Ballot must be held in order for the Expert Group to resume its activities at a future date.
If a JSR Renewal Ballot fails the Expert Group will have 30 days to update the JSR in response to the concerns raised by the EC, and may submit a revised version to the PMO. If a revised JSR is not received by the end of the 30 days, the original decision by the EC shall stand and the JSR shall be closed. If a revision is received, then the PMO shall forward it to the EC and initiate a JSR Renewal Reconsideration Ballot. At the close of balloting, all comments submitted by EC members, together with their ballots shall be circulated to the Expert Group by the PMO. If this ballot fails, the JSR shall be closed and the Expert Group shall disband.
If a JSR that is closed through these processes was a revision to an existing Specification, the Spec Lead shall resume the role of Maintenance Lead of the current Specification.
The Spec Lead is responsible for defining the process whereby the TCK is used to certify implementations of the JSR as compatible. After the JSR is completed the Maintenance Lead must submit to the PMO at least quarterly a list of all implementations that have been certified as compatible and that have been released publicly or commercially. The PMO will publish this information on the JCP Website. If the Maintenance Lead submits the information in the form of a pointer to an already published list the PMO may choose simply to reference that list rather than duplicate it.
All substantive Executive Committee business should be conducted in the most transparent manner possible. EC transparency requirements are specified in a separate document, the EC Standing Rules.
During JSR reviews EC members are strongly encouraged to ensure that one or more technical members of their organizations review the draft and provide feedback to the Expert Group. EC feedback is particularly important to the Expert Group, and EC members are encouraged not to wait until ballot periods to raise concerns and issues.
Materials to be posted on the JCP Website for review, comment, or any other official EG or EC business should be submitted to the PMO, which shall post them on the JCP Website and announce their availability to Members and the public within seven days of receipt (holiday closures excepted.)
Unless otherwise specified in this document, any EG member can appeal to the EC regarding a decision, an action, or inaction by the PMO, a Spec Lead, or a Maintenance Lead that affects EG participation or issue-resolution and which cannot be resolved by other reasonable means. An appeal must be initiated by sending an email message to the PMO (firstname.lastname@example.org) in all cases, even if it affects the PMO itself. The message must describe the issue under appeal clearly and concisely, with a short and relevant subject line, and must provide all relevant documentation to support the appeal. The PMO shall transmit the message to the EC no later than seven days after receipt. The EC shall then respond to the appellant within 30 days, either with a resolution or with a request for clarification and/or further documentation.
One or more Full Members may initiate a request to develop a new Specification, or carry out a significant revision to an existing one, by submitting a JSR proposal through the JCP Website, as described in the Spec Lead Guide. Upon request to the PMO, any JSR proposal may be withdrawn by the submitter(s) without explanation prior to the completion of the JSR Approval Ballot.
The following information must be provided with each JSR:
Existing Specifications, together with their associated RIs and TCKs, are maintained by a designated Maintenance Lead using the processes described in section 3.6 of this document. Maintenance Leads are expected to assume long-term ownership of the Specification, RI, and TCK while respecting the wishes of JCP Members regarding evolution. Maintenance Leads shall therefore be the Spec Leads for all significant revisions to their Specifications, but they shall not have the exclusive right to decide when a significant revision will take place. That shall be decided by the EC in response to a revision JSR that can be initiated by any JCP Member. Submitter(s) should make a reasonable effort to recruit members of the previous Expert Group to join any such revision effort.
Changes to the Java programming language, the Java virtual machine (JVM,) the Java Native Interface (JNI,) packages in the "java.*" space, or other packages delivered only as part of Java SE, have the potential to seriously disrupt the installed base if carried out inconsistently across the Platform Editions. In order to protect the installed base, any such changes can only be accepted and carried out within an Umbrella JSR (UJSR) for Java SE.
In order to guard against fragmentation, new Platform Edition Specifications must not substantially duplicate existing Platform Editions or Profiles.
All new or revised Specifications must be compatible with the most recent versions of the targeted Platform Edition Specifications. In order to achieve this, all UJSRs to define new Profile Specifications or revise existing Profile Specifications must reference either the most recent Release version of the Platform Edition Specification they are based upon or a newer version of that Specification that is under development via an active UJSR.
JSR submissions are required to state whether the JSR's RI and TCK will be delivered as part of a Profile or Platform Edition, in standalone manner, or both. The final decision as to whether a specific JSR is included in a Profile or a Platform Edition is made by the Spec Lead and Expert Group of the Platform Edition or Profile JSR, and is confirmed by the EC ballots on the relevant JSR. If the Spec Lead for the Platform Edition or Profile JSR turns down a request for inclusion then the JSR must deliver a standalone RI and TCK.
Technologies may be incorporated into a Profile or Platform Edition after having been initially delivered standalone. A JSR for a new version of an API that proposes to become part of a Profile or Platform Edition and is considering discontinuing standalone availability must state the rationale for this change and must inform the public of the intention to discontinue the availability of the standalone RI and TCK one JSR release in advance.
When a JSR is received, the PMO shall give it a tracking number, create its JSR Page, announce the proposed JSR to the public, and begin JSR Review. Comments on the JSR should be provided through the JSR's public feedback communication mechanism. Comments shall be forwarded to the EC for its consideration and shall be made available from the JSR Page (similar comments may be consolidated.)
Members who are interested in joining the Expert Group or participating as Contributors should identify themselves by informing the Spec Lead and the PMO. The Spec Lead is encouraged to actively recruit EG members and Contributors during this period and to update the JSR Page with the names of those who wish to help, since demonstrating broad interest in and diversity of representation on the JSR will significantly increase the chances of the EC approving it.
If the Member who holds the Spec Lead position withdraws from the JCP before the JSR is approved the PMO shall request the preliminary Expert Group to choose a replacement.
The Spec Lead is responsible for developing the Reference Implementation and Technology Compatibility Kit and for licensing them as described in the JSPA. The Spec Lead must provide the EC with complete copies of the proposed Specification, RI, and TCK licenses no later than the start of JSR Review. The PMO will publish the licenses on the JSR Page. EC members should provide feedback on the terms as an indication of how the community as a whole might react to the terms. If EC members believe that the proposed licensing terms are not compatible with the licensing guidelines established for use within the JCP, then balloting on the proposed JSR shall be delayed until Oracle legal provides an opinion on the matter.
After the JSR Review EC members shall review the JSR and any comments received, and cast their ballot to decide if the JSR should be approved.
If the JSR Approval Ballot fails, the PMO shall send all EC comments to the JSR submitter(s) who may revise the JSR and resubmit it within 14 days. If a revised JSR is not received in that time, the original EC decision shall stand and the JSR shall be closed. If a revised JSR is received, the PMO shall post it to the JSR Page, announce the revised JSR to the public, and send it to all EC members for a JSR Reconsideration Ballot. If that ballot fails, the JSR shall be closed.
After JSR approval the PMO instructs the Spec Lead to formally create the Expert Group and to identify the Members who will serve as Contributors. The PMO will update the JSR Page accordingly.
3.4 Draft Releases
The Expert Group should begin work by considering the requirements set forth in the JSR, any contributed documents or technology descriptions, comments received during JSR Review and, if this is a revision of an existing Specification, the Issue List maintained by the Maintenance Lead (see section 3.6.) Additional input can be obtained from discussions with other Members, industry groups, software developers, end-users, and academics. The goal is to define requirements and then write a draft Specification suitable for review by the community and the public.
When the Expert Group decides that the first draft is ready for review, the Spec Lead shall post the draft and send the draft, along with any additional files required for review, to the PMO, which shall publish these online and make them available for download by the public. The Spec Lead should also suggest the length of the Early Draft Review period if the Expert Group feels it should go beyond the minimum 14 days.
Multiple Early Drafts (and Early Draft Reviews) are encouraged where the Expert Group feels that this would be helpful.
Early Draft Review begins when the PMO announces the availability of the draft Specification for Early Draft Review. The goal of Early Draft Review is to get the draft Specification into a form suitable for Public Review as quickly as possible by uncovering and correcting major problems with the draft. Early Draft Review is an early-access review, and should ideally take place when the Specification still has some unresolved issues. The public's participation in Early Draft Review is an important part of the process since in the past comments from the public have raised fundamental architectural and technological issues that have considerably improved some Specifications.
If the Expert Group makes major revisions to the draft during Early Draft Review the Spec Lead should post the revised draft and send the revised draft, along with a synopsis of the changes, to the PMO, which shall publish these online and make them available for download by the public.
After the Early Draft Review period has ended, the Expert Group can make any additional changes to the draft it deems necessary in response to comments before submitting the draft to the PMO for the next review.
When the Public Review draft of the Specification is ready for review, the Spec Lead shall post the draft and send the draft, along with any additional files required for review, to the PMO, which shall publish these online and make them available for download by the public.
Public Review begins when the PMO announces the availability of the draft Specification for public review and comment.
The Spec Lead is responsible for ensuring that all comments are read and considered. If those comments result in revisions to the draft and those revisions result in major changes (in the opinion of the Expert Group,) then the Spec Lead must post an updated draft and send the updated draft (with a summary of the changes) to the PMO at least 3 days before the review period ends. The PMO shall post the new draft and the change summary on the JCP Website before the review period ends and shall notify the public that the new draft is available.
The Public Review Ballot starts when the Public Review closes. At the close of balloting, all comments submitted by EC members with their ballots shall be circulated to the Expert Group by the PMO.
If the Public Draft Specification Ballot fails, the Expert Group will have 30 days to update the draft in response to the concerns raised by the EC and to submit a revised version to the PMO. If a revised draft is not received within 30 days, the original decision by the EC shall stand and the PMO will declare the JSR closed. If a revision is received, the PMO shall forward it to the EC and initiate a Public Draft Specification Reconsideration Ballot. At the close of balloting, all comments submitted by EC members with their ballots shall be circulated to the Expert Group by the PMO. If this ballot fails, the JSR will be closed and the Expert Group will be disbanded. If the JSR was a revision to an existing Specification, the Spec Lead shall resume the role of Maintenance Lead of the current Specification (see section 3.6.)
If the Public Review Ballot (or Reconsideration Ballot) is successful, the Expert Group shall prepare the Proposed Final Draft of the Specification by completing any revisions it deems necessary to respond to comments. The Spec Lead shall then send the Proposed Final Draft to the PMO, which shall post it on the JCP Website for public download.
The Spec Lead is responsible for the completion of both the RI and the TCK. JSRs that are targeted at more than one platform are required to support each environment, which may require a separate RI and TCK for each environment. If the RI and TCK uncover areas of the Specification that were under-defined, incomplete, or ambiguous, the Spec Lead shall work with the Expert Group to correct those deficiencies and then send a revised Specification together with a summary of the changes to the PMO. Information shall be posted to the JCP Website. The Expert Group shall continue to consider any further comments received during this time.
The Spec Lead is also responsible for establishing a clearly defined First Level TCK Appeals Process to address challenges to tests contained in the TCK. This process must be described in the TCK documentation. Implementers who are not satisfied with a first level decision should appeal to the EC by documenting their concerns in an email message to the PMO. The PMO will circulate the request to the EC, together with any information received from the ML concerning the rationale for the first-level decision, and initiate a 7-day Appeal Ballot.
Depending on the nature of the problem, a successful TCK challenge will require updating one or more of the TCK, the Specification, and the RI. Within 30 days of the close of a successful TCK Appeal Ballot the Maintenance Lead must update these deliverables as necessary and report the changes to the PMO when the Specification (if changed) and URLs for the updated RI and/or TCK are delivered for publication on the JCP Website.
When the Expert Group is satisfied that the TCK provides adequate test coverage, the RI correctly implements the Specification, and the RI passes the TCK, the Spec Lead shall send the Final Draft of the Specification to the PMO together with instructions on how EC members can obtain the RI and TCK for evaluation. The PMO shall circulate the materials to the EC and initiate the Final Approval Ballot. At the close of balloting, all EC comments shall be sent to the Expert Group by the PMO.
In order to assist the PMO in tracking the number of “Active JSRs”, at the time of submission of the final materials the Spec Lead shall inform the PMO whether it is expected that the JSR will be further developed via Maintenance Releases or a new follow-on JSR. The TCK submitted as part of the Final Draft must meet the following requirements:
If no responses are received within 30 days the original decision of the EC shall stand, the PMO shall close the JSR, and the Expert Group shall disband. If the JSR was a revision to an existing Specification, the Spec Lead shall resume the role of Maintenance Lead of the current Specification (see section 3.6.)
If a response is received, the PMO shall circulate it to all EC members for a Final Approval Reconsideration Ballot. At the close of balloting, all ballot comments submitted by EC members shall be circulated to the Expert Group by the PMO. If the reconsideration ballot fails, the JSR will be closed and the Expert Group will disband. If the JSR was a revision to an existing Specification, the Spec Lead will resume the role of Maintenance Lead of the current Specification (see section 3.6.).
Within 14 days of a successful Final Approval Ballot or Reconsideration Ballot, the PMO shall publish on the JCP Website the Specification and links to information on how to obtain the RI and TCK, and shall announce the availability of these materials to both Members and the public. The published TCK information must include a means for any interested party to obtain a copy of the TCK documentation at no charge. Upon Final Release, the Expert Group will have completed its work and disbands. The Spec Lead will typically become the Maintenance Lead and may call upon Expert Group members and others for aid in that role.
The Maintenance Lead must ensure that the links to the RI and TCK remain valid. If the links become non-functional the Maintenance Lead will have 30 days following notification from the PMO to correct them. If the problems are not corrected the PMO will initiate a JSR Withdrawal Ballot (if no Maintenance Release has been completed) or a Maintenance Release Withdrawal Ballot (if a Maintenance Release has been made) to determine whether the Maintenance Lead shall be judged to have abandoned the JSR. If the ballot passes the JSR itself or the relevant Maintenance Release will be marked as withdrawn.
The Maintenance Lead is expected to assume long term ownership of the Specification, RI, and TCK while respecting the JCP Members’ wishes regard to evolution. A Maintenance Lead shall therefore automatically be the Spec Lead for all significant future revisions to their Specification but shall not have the exclusive right to decide when a significant revision will take place (see section 184.108.40.206.)
The Maintenance Lead may, however, relinquish the role at any time as described in section 220.127.116.11.
The public may submit requests for clarification, interpretation, and enhancements to the Specification by logging issues through the JSR's Issue Tracker.
The ML shall consider all requests and shall decide how and if the Specification should be updated in response. The ML is not required to perform these tasks alone, but should consult with the former members of the Expert Group, or any other sources, to assist with the Maintenance duties.
The ML should operate in a transparent manner, enabling Members and the public to observe the process and the updates to the Specification and to comment on the changes. The ML may request the PMO to publish the transparency mechanisms (E.g., the communication mechanisms and the Issue Tracker) on the JSR Page for the Specification undergoing maintenance.
All changes proposed by the ML shall be incorporated into the Specification either through the Maintenance Release process (described below) or through a new JSR. Changes appropriate for a Maintenance Release include bug-fixes, clarifications of the Specification, changes to the implementation of existing APIs, and implementation-specific enhancements. Changes introduced in Maintenance Releases - for example, modifications to existing APIs or the addition of new APIs - must not break binary compatibility as defined by the Java Language Specification. Changes that would break binary compatibility should therefore be deferred to a new JSR.
The Maintenance Lead shall document all proposed Specification changes through the Issue Tracker and then send a request to the PMO to initiate a Maintenance Review. This request must be accompanied by an Issue List that summarizes all formal comments that have been received and that indicates the disposition of each Issue. The Maintenance Lead must also supply a summary of the proposed Specification changes, ideally in the form of a diff between the proposed and the current Specification. The Maintenance Lead must also provide an estimate of when the final materials for the Maintenance Release will be delivered. If no estimate is provided the deadline will default to 30 days.
The PMO shall post the materials on the JCP Website for public review. By default the Maintenance Review period is 30 days, but if time is short the Maintenance Lead may request the PMO to grant an exception and reduce the review period to 14 days.
The Maintenance Lead may choose to modify one or more of the proposed changes based on comments received during the review. If so, the ML must deliver the appropriate modified materials to the PMO no later than 3 days before the close of the review and the PMO must post them online before the close of the review.
At the close of the Maintenance Review the PMO shall initiate a Maintenance Review Ballot. During this ballot EC members should vote 'yes' if they agree that the Maintenance Release should proceed as the Spec Lead has proposed, and 'no' if they have objections to the proposed release on one of the following grounds:
If the ballot fails, the Maintenance Lead may make any necessary corrections before requesting another Maintenance Review and ballot. The process may be repeated any number of times.
After a successful Maintenance Review Ballot the Maintenance Lead will update the Specification, RI, TCK, and Issue List as necessary and submit them to the PMO for publication in a Maintenance Release. The PMO verifies that the necessary changes have been made, and publishes the Specification, the Issue List, and pointers to the RI and TCK on the JSR Web Page.
NOTE: until the Maintenance Release stage is reached any proposed changes should be considered preliminary and subject to change, and therefore should not be implemented in shipping products.
In order to assist the PMO in tracking the number of "Active JSRs", at the time of submission of the final materials the Spec Lead should inform the PMO whether it is expected that the JSR will be further developed via Maintenance Releases or a new follow-on JSR.
If the Maintenance Lead fails to deliver the final materials within the time period specified at the beginning of the Maintenance Review process the PMO shall inform the Maintenance Lead of an impending Maintenance Renewal Ballot, and shall request the Maintenance Lead to prepare a public statement to the EC that explains the reason for the delay and provides a new deadline. 30 days after this request the PMO shall initiate a Maintenance Renewal Ballot to determine whether the deadline may be extended as requested or whether the previous Maintenance Review should be rescinded and the Maintenance Lead be required to go through another Maintenance Review.
The Executive Committee (EC) oversees the development and evolution of the Java technologies within the JCP.
The EC is composed of 25 Java Community Process Members whose seats are allocated as follows: 16 Ratified Seats, 6 Elected Seats, and 2 Associate Seats, plus one permanent seat held by Oracle. (Oracle's representative must not be a member of the PMO.) The EC is led by a non-voting Chair from the PMO.
Full Members and Partner Members can run for election to EC seats. Associate JCP Members cannot run for election.
No Member may hold more than one seat on the EC. Therefore, should a Member on the EC acquire a majority ownership of another EC member, one of those members must resign his or her seat by the effective date of the acquisition. Similarly, no Member may run for more than one EC seat, nor may more than one individual Member or Partner Member employed by the same employer run for an EC seat.
The Executive Committee has the following responsibilities:
Members of the Executive Committee should be dedicated to the principles of full and open competition, in full compliance with all applicable laws, including all antitrust laws of the United States and other nations and governmental bodies as appropriate. Violations of such laws can result in criminal as well as civil penalties for individuals as well as employers, depending on the jurisdiction. In particular, any discussion related to product pricing, methods or channels of distribution, division of markets or allocation of customers, among other subjects, should be avoided.
EC members serve two-year terms, which are staggered so that half of the seats are up for election each year. Full Members and Partner JCP Members vote for the Ratified and Elected Seats. Associate JCP Members vote for the Associate Seats.
EC members may resign their seats at any time during their term.
EC members who fail to remain JCP Members forfeit their EC seat.
Seats may also be forfeited due to non-attendance at EC meetings, as specified in the EC Standing Rules.
Vacated seats are normally filled for the remainder of their term by a special election ballot that will be held no later than two months after the resignation unless the resignation is less than six months before the next scheduled annual election ballot.
All Full Members are eligible to vote in ballots for Ratified and Elected Seats subject to the provision that if a Member has majority-ownership of one or more other Members then that group of Members shall collectively have one vote, which shall be cast by the person they designate to be their representative for the ballot in question. Similarly, if there is more than one individual Full Member with the same employer they will collectively have one vote, which shall be cast by the person they designate to be their representative for the ballot in question.
Annual elections for Ratified, Elected and Associate Seats shall be held simultaneously. Voting in these elections shall start in the last quarter of the calendar year, four weeks after the close of the nomination period.
In the interest of promoting transparency and participation in the election process the PMO shall organize teleconferences at which the Members have an opportunity to hear from and to ask questions of the candidates. If a suitable venue such as JavaOne is available the PMO shall also organize a public meeting with the same purpose.
Members are selected for the Ratified Seats using a ratification ballot which is carried out as follows:
Members are selected for the Elected and Associate Seats using an open election process that is carried out as follows:
Revisions to the Java Community Process (this document) and the Java Specification Participation Agreement shall be carried out using the Java Community Process with the following changes:
In addition to the modified documents (the Process Document and/or the JSPA) the Expert Group shall therefore publish a JSR Review and Evaluation form containing evaluation questions relating to each non-trivial change introduced by the JSR.
Within 12 months of completing the JSR the EC must to use this form to review and evaluate the implementation
of the JSR. The EC should then take any actions it might think necessary to correct or improve any identified problems or omissions. In the interests of transparency the results of the review and a summary of all follow-on actions taken must be made public.
In the previous version (2.9) of this Process Document there were only two different types of EC seats: Ratified and Elected. In JCP 2.10 two of the existing Elected Seats will be reclassified as a third type: Associate Seats, which will be voted on by the new Associate members.
In order to ensure sufficient time to transition existing individual members to the new membership classes (either Full Members with a signed Employer Contribution Agreement or Associate Members), and to recruit a significant number of new Associate Members, the first election to be held under the JCP 2.10 rules will be in 2016.
The transition from Elected Seats to Associate Seats must be performed in a manner that is fair to all Elected members; consequently all of those members will be required to run for reelection in 2016 when the new Associate Seats will be created.
Candidates in the 2015 annual elections were informed that if elected their term would be for only a single year, since all candidates must stand for re-election in 2016. Members elected in 2016 will be ranked to determine whether their initial term will be one or two years. The 50% of Elected and Associate members who receive the most votes will serve an initial two-year term, while all others will serve an initial one year term. All members elected in 2017 and subsequently will serve a two-year term.