Find JSRs
Submit this Search


Ad Banner
 
 
 
 

Introduction
FAQ: Spec Lead Questions
 

General questions |  Membership questions |  JSR and Expert Group questions |  Spec Lead process questions |  Login questions |  Web Site questions |  Glossary  
 

Spec Lead JSR Questions
 
 
Spec Lead Expert Group Questions
Spec Lead JCP Version Questions
 
Spec Lead JSR Questions
Q: How long does it take to move through the JSR process?
A:

There is also the JCP Gantt chart, which applies to JSRs under JCP version 2.8 and newer.
 
Q: I share the Spec Lead role with X other people. How can I change the order of the Spec Lead names listed on the JSR XXX detail page?
A: Multiple Spec Leads are listed alphabetically by last name/surname. This order is built into the site and cannot be changed.
 
Q: The Member I represent as Spec Lead is considering canceling its Full Membership. How will that affect my JSR?
A: When a Full Member cancels its Membership, all of its active representatives are removed from all JSRs and their accounts are deactivated. This means that you will no longer be the Spec Lead of any JSRs you currently lead. It also means that you will be removed from any Expert Groups on which your organization is represented. JSRs must find new Spec Leads or be withdrawn, though JSRs that have gone final already will maintain a record that your organization had Contributed or was on the Expert Group.
 
Q: For whatever reason, I can no longer act as Spec Lead. How do I end my JSR(s)?
A: Your JSRs do not end when you leave the Spec Lead role. If the Full Member you represent will still be a Member after you leave, it is responsible to appoint a new person to act as its representative Spec Lead. Please make sure to communicate the identity of your replacement to the PMO at admin@jcp.org before you leave.
If, however, the Full Member you represent is also leaving the Spec Lead role, you need to attempt to find a new Full Member to assume the Spec Leadership. Let the PMO know via admin@jcp.org that you are trying to find a new Spec Lead. Next, the minimum effort must be to ask the Expert Group of the JSR if any of them are willing and able to fill the role of the new Spec Lead. If no one on the Expert Group (or any other JCP Member representative) is ready to act as Spec Lead, then the JSR will be withdrawn.
 
Q: I'm ready to submit a draft for a posting. How do I do this?
A: The Spec Lead Guide provides detailed instructions for submitting each milestone for a JSR.
 
Q: I want to let the community know what's happening with my JSR. How can I do this?
A: You may do this in a number of ways, such as posting to a web journal, blog, web site, collaborative project page, et cetera. However, you should always make sure that you provide links to those sites on the JSR's pages on jcp.org, as that is the place most people will look for information first. jcp.org also provides a number of ways to communicate with the community. As a Spec Lead, you can:
  • Post updates to your Community tab.

    Every JSR has an area set aside for Spec Leads to edit with up-to-the-minute information about the progress of their JSR, questions being considered in the Expert Group, and the like. You reach this by clicking the "Community" tab on your JSR's page. This points to http://jcp.org/en/egc/view?id=XXX, where "XXX" is the JSR number. As Spec Lead, you can edit the HTML of that page as well as post files for the community to view. For more information about updating your Community tab, you may listen to the audio recording of the Community tab talk (the tab used to be called a "Community Update tab").

  • JCP 2.8 and newer JSRs are required to provide a public communications "channel" and an Issue Tracker. If you are the Spec Lead for a JSR under JCP version 2.8 or newer, you will have already created these two things, and you should be using the channel for all Expert Group communication and the Issue Tracker to track all issues relating to the JSR.

 
Q: I've updated my Community tab, but I want to make changes to the old, out-of-date information on my JSR detail page. How do I do this?
A: You may send edits to the JSR detail page to admin@jcp.org and the PMO will add these changes to the "Updates to the original JSR" section on the JSR detail page. When you send these updates/changes, make sure to send just the changed sections.

Note that edits cannot be made to a JSR detail page during any of the JSR ballots. Also realize that every section of the JSR detail page and all changes to those sections will remain for historic record; they will not be deleted. In this way, the community can track the progress of the JSR over its lifetime: how the schedule changed, how the initial ideas may or may not have changed leading up to the Final Release, et cetera.
 
Q: I looked at my JSR page, and I see that my JSR is listed as "Inactive"! What does that mean?
A: The "Inactive" label means that no milestones for your non-Final JSR have been posted for at least 12 months. If your JSR does not post a milestone for more than 18 months, the PMO will approach you about withdrawing your JSR. Note, however, that the Inactive label is not intended to mean that no work has been done on the JSR: your updates to the JSR detail page and the Community tab, as well as traffic on discussion forums or aliases you may have created for your JSR, should all make your work on the JSR clear to the community.
 
Q: I would like to withdraw my JSR. How do I do this?
A: Usually a PMO will contact you about withdrawing your JSR, such as when your JSR has been Dormant for an extended period. But if you have tried and failed to find a replacement Spec Lead, you can initiate withdrawing your JSR. Just send mail to admin@jcp.org with the subject line "Withdraw JSR XXX" (where 'XXX' is your JSR's number). Make sure that the body of the message includes a reason for the withdrawal; this reason will be posted online as the record for why the JSR was withdrawn.
 
Q: I'm ready to submit a new JSR proposal, but I don't have the final license terms decided yet. What do I do?
A: Do the work to figure out the final license now. Then come back to submit the JSR proposal form once you have the full license text for the Final Release Specification, Reference Implementation and Technology Compatibility Kit. JCP 2.7 and later JSRs submitted without the full license text are incomplete.
 
Q: My JSR has a milestone with a ballot approaching. What factors can affect when a ballot begins and ends?
A: All ballots start on Tuesdays, and they usually end on Mondays. Mostly, the ballot lengths are determined by the type of ballot it is, as follows:

  • JSR Approval Ballot: 7 days
  • Draft Specification Approval Ballot (JCP 2.0 - 2.5): 1 week, last week of Community Review period
  • Public Draft Specification Approval Ballot (JCP 2.6 - 2.7): 1 week, last week of Public Review period
  • Public Draft Specification Approval Ballot (JCP 2.8 - 2.9): 1 week, starting first Tuesday after the Public Review
  • Public Review Ballot (JCP 2.10): 1 week, starting first Tuesday after the Public Review
  • Final Approval Ballot (JCP 2.0-2.10.1): 2 weeks
  • Final Approval Ballot (JCP 2.10.2): 1 week
  • Item Exception Ballot (JCP 2.0 - 2.7): 1 week
  • Appeal Ballot (JCP 2.8 - 2.10): 1 week
  • Renewal Ballot (JCP 2.8 - 2.10.1): 2 weeks
  • Renewal Ballot (JCP 2.10.2): 1 week
  • Withdrawal Ballot (JCP 2.8 - 2.10.1): 2 weeks
  • Withdrawal Ballot (JCP 2.10.2): 1 week
  • Maintenance Review Ballot (JCP 2.8 - 2.10): 1 week, first Tuesday after Maintenance Review
  • Transfer Ballot (JCP 2.8 - 2.10.1): 2 weeks
  • Transfer Ballot (JCP 2.10.2): 1 week

For ballots that take place at the end of a review period, the duration of the review period, taken with the fact that all ballots start on Tuesdays, can affect when the ballot begins. Review periods never are shorter than the minimum length (14 or 30 days, depending on the review), and so a ballot may start as much as 6 days after the review closes. For instance, a Community Review that started on a Wednesday for a thirty-day review would end on a Friday, 4 days before the Community Draft Approval Ballot would begin on the following Tuesday.

Two other factors can affect the beginning and end dates of a ballot: PMO holidays and the EC changeover following an EC Election. Both should be listed on the JCP calendar.

When the PMO is closed for a holiday, EC Ballots may be affected. If a ballot would close on a Monday that the PMO is closed for a single-day holiday, the ballot is instead extended to the day after (Tuesday). Ballots will not span a multi-day holiday, however: instead they are postponed until after the holiday period. For example, a ballot will not begin on the Tuesday before Christmas, but would instead start on the first Tuesday of the New Year.

Each year the Executive Committee Elections are held in the Fall, and there is a period when the old EC has left and the new EC has yet to begin. Ballots that would begin or end in this period are instead postponed until the new EC begins its term. This means that a 1-week ballot may not begin from the time the old EC ends its term until the new EC begins its term, and it means that a 2-week ballot may not begin the last week of the old EC's term but will be postponed until the new EC begins its term.

Q: My JSR is in a ballot being voted on by the Executive Committee. How can I tell what the status of the ballot is?
During the ballot, a link to "current ballot results" appears on the JSR Stage table for any Specification Lead of that JSR. Click that link to view a tally of the current votes and all comments that EC Members have posted on the ballot.

Q: I've just submitted my Proposed Final Draft. When will the Final Approval Ballot begin/end?
A: Sometime after the Proposed Final Draft is posted, depending on when you submit the materials for the Final Approval Ballot. The Final Approval Ballot is a separate milestone from the posting of the Proposed Final Draft with a separate set of instructions and deliverables. Submitting the materials for Proposed Final Draft does not result in a Final Approval Ballot, as they are separate.

Q: I have more questions that aren't answered here. Are there any more resources for Specification Leads?
A: The primary reference for Specification Leads is the online Spec Lead Guide. Most information about moving a JSR through the process is available there. Also, if you have questions, you can always send them in e-mail to pmo@jcp.org.  

Spec Lead Contributor and Expert Group Questions

Q: I have someone in mind to become a Contributor or Expert Group member. How can I make this happen?
A: The following must happen:

  1. The person must register for the site, if he or she hasn't already done so in the past
  2. The person must fill out the Expert Group nomination form and submit it (if the nominee is missing any legal agreements related to participating in the JCP, the PMO will follow up with the nominee)
  3. The Spec Lead must go to his JSR's page on jcp.org, log in, and click on the "Administration" tab
  4. The Spec Lead must find the nomination in the list of open nominations
  5. The Spec Lead must consult with the existing Expert Group before approving any new nominations (JCP 2.8 and newer)
  6. The Spec Lead casts a vote for the nomination: Y to approve, N to reject, or P if more time is needed (as when the Spec Lead contacts the nominee to discuss it)
  7. The Spec Lead posts the nomination, the vote on the nomination, and all discussion and/or materials related to the decision on how to vote on the nomination, to the public (JCP 2.8 and newer)
  8. When the Spec Lead and the PMO have both approved the nomination, the nominee is added as a Contributor or Expert Group member.

 
As a Spec Lead, I'm required to publish information about the JSR nominations. What do I need to post, and how?
A: Spec Leads of JSRs operating under JCP 2.8 and later have a requirement to publish JSR nomination information publicly, both for Contributors and Expert Group members. This includes the name of the JCP Member, the name of the nominee, the status of the nomination (considering, approved, rejected), and any deliberations you had in coming to your decision. JCP 2.8 and newer JSRs have all provided information about their public communication channels in section 2.19 of their JSR proposals: you should be posting all this information for each nomination you receive there, in that public communication channel.
 
Q: I've voted to approve a nomination, but the person isn't on my JSR page yet. What's the delay?
A: The PMO has not approved the nomination, for one of several reasons. The reasons are described below, with the corresponding vote you will see on the EG nomination page in parentheses:
  • PMO hasn't voted on the nomination yet (-)
  • the nominee needs to represent a JCP Member (XJ)
  • the nominee is an individual Full Member who needs an Employer Contribution Agreement for your JSR (XB)
  • the nominee is otherwise legally unable to participate (X)
  • the nominee has submitted all the requisite paperwork and it is being processed (P)
  • there are problems with the paperwork the nominee has submitted (I)

Note that this information is also provided in the vote legend on the EG nomination page.
 
Q: Some of the experts on my Expert Group have changed their contact info. How can this be updated on jcp.org?
A: The easiest way is for the expert to log in and make the changes himself. Any registered user on jcp.org can maintain his own contact information by clicking "My Profile" and then "Edit Profile" if changes are needed. Changes to e-mail addresses may take up to 24 hours to refresh to all servers, so don't be alarmed if the updates don't instantly take effect.
NOTE that this cannot be used to change which company/organization an expert represents (see next question).
 
Q: Some of the Contributors and/or Expert Group members on my group have moved from one JCP Member company to another. Can I make those edits on the Expert Group private page?
A: No. Each person's account is tied to a specific JCP Membership, so editing the e-mail address will not change which Members are listed on the JSR page as Contributors or Expert Group members. To make the change, notify the PMO of which people are moving from Member X to Member Y, and that you approve their continued participation as representatives of Member Y. In parallel, have the people submit new nominations for your JSR as representatives of Member Y. The PMO will remove the people and, once they have submitted new nominations, will approve their addition. Then all that remains is for you to approve the nominations and the people will be back on the JSR page with the correct Member affiliation.
 
Q: My Expert Group is complete and I want to close the EG from receiving further nominations. How do I do that?
A: First, notify the PMO (pmo@jcp.org) that you wish to close your Expert Group and provide the reason for that closure in the e-mail. The PMO will update the JSR page and remove the "I would like to join this Expert Group" link. Second, post the reason for the closure to your public communications channel so that the community can know why your EG is closed.
Note that this will also remove the link for Contributors, but you can always direct people whom you would like to add as either Contributors or Expert Groups members to go directly to the nomination form to nominate themselves.
 
Q: I have contacted a person I'd like to add to the JSR as a Contributor or Expert Group member, but the "I would like to join this Expert Group" link is missing! What do I do?
A: The "I would like to join this Expert Group" link disappears in either of two circumstances: you request to close the Expert Group, or the JSR posts its Final Release. If the JSR hasn't produced a Final Release and you want to re-open the Expert Group, just send a message to the PMO (pmo@jcp.org) asking to reopen the EG.

Alternatively, the person can still nominate to a closed Expert Group. The person goes to the EG nomination form and fills it out as usual, specifying the closed JSR. But the Spec Lead must notify the PMO to accept this one nominee as an exception, because by default the PMO will reject new nominations to closed Expert Groups.
 
Q: I'm the Maintenance Lead for JSR XXX. How do I add Contributors and/or Expert Group members?
A: Though you may choose to actively solicit proposed changes from the community for your Change Log, the Expert Group officially disbanded at Final Release. No additions or subtractions are made to the list of Contributors or Expert Group members following Final Release.
 
Q: I submitted a JSR but the people I listed as being on the Initial Expert Group are not listed in the Expert Group table and/or the Expert Group private page for my JSR! What gives??
A: All experts on Expert Groups must nominate themselves using the online nomination form, so that it isn't just you saying that they want to be on the Expert Group. In addition, for JCP 2.8 and newer JSRs, all JSR nominations must be made public, along with your decisions on the nominations and any discussion/deliberations on those decisions. This includes your Initial Expert Group.
 

Spec Lead JCP Version Questions
Q: I've heard a lot about the changes that have come with JCP 2.7, and I wonder: how do these changes affect me?
A: There are a lot of changes. They are summarized here for your reference.
 
Q: JCP 2.8 mentions an issue tracker for my JSR, but I don't see it anywhere on the site. What do I do?
A: You have to create one of your own, but we do have a guide on how to create one on java.net.
 
Q: What has changed for Spec Leads in JCP 2.8?
A: For a summary of the changes to the process, please refer to this 2.8 overview page.
 
Q: What are the differences between JCP 2.8 and JCP 2.9?
A: JCP 2.9 is exactly the same as JCP 2.8, but that it describes how the previously separate Executive Committees have merged into the single Executive Committee we have now.
 
Q: How is JCP 2.10 different from JCP 2.9?
A: JCP 2.10 makes three changes to the JCP: all JSR ballots are set to be 7 days in length, two more Member categories are introduced (Partner and Associate Members, in addition to the original Full Members), and the Executive Committee is modified to be composed of seats that correspond to the different types of JCP Members. For more detail about what's new in JCP 2.10, refer to the overview of JCP 2.10 changes page.
 
Q: What do I need to know about what's different in JCP 2.11?
A: JCP 2.11 makes significant changes to the lifecycle of a JSR, introduces the option of Iterative JSRs, and the option of Errata Maintenance Releases. For a more detailed summary of the changes to the process in JCP 2.11, please refer to the JCP 2.11 overview page.
 
Q: My JSR is in JCP 2.8. What will happen to it now that JCP 2.9 has released?
A: Your JSR will be listed as operating under JCP 2.9 as soon as you publish the next JCP milestone for your JSR.
 
Q: With JCP 2.8/2.9, am I required to allow public users to post to my Issue Tracker?
A: JCP 2.8 and above requires that you track all Issues that have been raised with a publicly readable Issue Tracker. You may choose to allow the public to submit issues directly into your Issue Tracker, or you may choose only to allow reading of the tracker...as long as you have provided explicit instructions on how the public can submit issues to be logged.
 
Q: The schedule for my JCP 2.8/2.9 JSR is slipping, and I'm worried that I'm going to miss one of the deadlines! What do I do?
A: JCP 2.8 introduced the ideas of deadlines for certain milestones in a JSR's development: 9 months to produce an Early Draft Review, 12 months after that to post a Public Review, 12 months after that for the Final Release, and the Maintenance Lead must set his/her own target for Maintenance Release when submitting changes for a Maintenance Review. The Executive Committee has the option of calling for a Renewal Ballot to decide if the JSR should be allowed to continue or be withdrawn when a deadline is missed, but these renewal ballots don't happen automatically. If the Executive Committee is made aware of your extenuating circumstances - for instance if you explain it to the committee representatives - then they may let you set a new deadline without calling for the Renewal Ballot.
 
Q: I submitted my JCP 2.9 JSR; when will it go up for JSR Approval Ballot?
A: If there is a problem with your submission, the PMO will contact you with a request for clarification or to identify the missing pieces, but the PMO will always respond to submitters via e-mail to confirm receipt of the submission. If you have not received such a confirmation, it is possible that the PMO did not receive your submission.

Note, too, that JSR Review and the JSR Approval Ballot are separate in JCP 2.8/2.9 and above. Part of your JCP 2.9 proposal indicated the length of time you wanted for the JSR Review, a review period that takes place before the JSR Approval Ballot which was introduced in JCP 2.8. So, once the JSR is posted, the review should be two weeks or four weeks before the ballot begins, according to whether you selected a 2 week or 4 week JSR Review. All ballots begin on Tuesdays, however, so your JSR Review will be extended to the Monday before the next ballot if 2 weeks or 4 weeks does not already fall on a Monday.
 
Q: My JSR has a milestone with a ballot approaching. What factors can affect when a ballot begins and ends?
A: All ballots start on Tuesdays, and they usually end on Mondays. Mostly, the ballot lengths are determined by the type of ballot it is, as follows:

  • JSR Approval Ballot: 2 weeks
  • Draft Specification Approval Ballot (JCP 2.0 - 2.5): 1 week, last week of Community Review period
  • Public Draft Specification Approval Ballot (JCP 2.6 - 2.7): 1 week, last week of Public Review period
  • Public Draft Specification Approval Ballot (JCP 2.8 - 2.9): 1 week, immediately after Public Review
  • Final Approval Ballot: 2 weeks
  • Item Exception Ballot (JCP 2.0 - 2.7): 1 week
  • Appeal Ballot (JCP 2.8 - 2.9): 1 week
  • Renewal Ballot (JCP 2.8 - 2.9): 2 weeks
  • Withdrawal Ballot (JCP 2.8 - 2.9): 2 weeks
  • Maintenance Review Ballot (JCP 2.8 - 2.9): 1 week, immediately after Maintenance Review
  • Transfer Ballot (JCP 2.8 - 2.9): 2 weeks

For ballots that take place at the end of a review period, the duration of the review period, taken with the fact that all ballots start on Tuesdays, can affect when the ballot begins. Review periods never are shorter than the minimum length (30 days), but may be extended to allow for the ballot length. For instance, a Community Review that started on a Wednesday for a thirty-day review would end on a Monday, 4 days after the Thursday that would be the actual 30 days after it began. In this example, the ballot would start on the last Tuesday of the review, which is actually the 28th day of the review.

It should be noted that, for ballots that take place after a review period, the reviews that they follow may be extended to the Monday before the ballot begins. For example, a 30-day JCP 2.9 Public Review starting on a Tuesday would end on a Monday, extended from the previous Wednesday (the actual 30th day), making the review period actually 35 days in length. Then the Public Draft Specification Approval Ballot would begin on the following Tuesday and run for one week as specified.

Two other factors can affect the beginning and end dates of a ballot: PMO holidays and the EC changeover following an EC Election. Both should be listed on the JCP calendar.

When the PMO is closed for a holiday, EC Ballots may be affected. If a ballot would close on a Monday that the PMO is closed for a single-day holiday, the ballot is instead extended to the day after (Tuesday). Ballots will not span a multi-day holiday, however: instead they are postponed until after the holiday period. For example, a ballot will not begin on the Tuesday before Christmas, but would instead start on the first Tuesday of the New Year.

Each year the Executive Committee Elections are held in the Fall, and there is a period when the old EC has left and the new EC has yet to begin. Ballots that would begin or end in this period are instead postponed until the new EC begins its term. This means that a 1-week ballot may not begin from the time the old EC ends its term until the new EC begins its term, and it means that a 2-week ballot may not begin the last week of the old EC's term but will be postponed until the new EC begins its term.

Q: I'm a JCP 2.8/2.9 Maintenance Lead. If there are no changes to the list of implementations, do I still need to provide the quarterly update?
A: Yes. Even if there is no change to the list, the list of publicly/commercially released implementations that have been certified as compatible must be provided to the PMO at least quarterly. Send it to admin@jcp.org.

Q: I'm a Specification Lead and I wish to move my JSR to JCP 2.10. How do I do this?
A: Send mail to admin@jcp.org with the answers to the following questions:

Which JSR do you want to move to 2.10?
Do all of the experts on your Expert Group agree to change to JCP 2.10?
What is the specific URL for the document archive?
What is the specific URL for the Issue Tracker?
What is the specific URL for the EG communication archive?
What is the description of your communications channel/how the public should provide feedback?
How will you consult with your Expert Group before adding any new experts to the Expert Group of your JSR?
How will you provide details of the Expert Group nominations for your JSR?

The PMO will confirm receipt and follow-up with you on any answers that aren't clear. Once the answers are clear and the Expert Group agrees to make the change, the PMO will update your JSR listing to show that your JSR is now operating under JCP 2.10.

Q: I'm the Spec Lead of a JCP 2.8/2.9/2.10 JSR. How do I consult with the Expert Group on new EG nominations?
A: Provide the relevant details of each nomination that comes in to the Expert Group: which JCP member is represented by the nominee, what the nominees qualifications are, the expertise of the nominee's organization, how many hours/week the nominee claims to be available to work on the JSR. You can do this in person, on the phone, or using a forum or mailing list. But you have to also make the deliberations on each nomination available to the public, as well, so you might wish to save yourself the trouble of transcribing the discussions and put it all into mail or a forum in the first place.
 
Q: I'm a JCP 2.8/2.9/2.10 JSR Spec Lead, and I'm supposed to make all deliberations, discussions, and decisions on every Expert Group nomination - as well as the nominee's name, qualifications and expertise - available to the public. How?
A: Use the public communications channel you created for JCP 2.8/2.9/2.10 and post the information about each nomination there.