[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
[jakarta.ee-spec.committee] Clarification for test challenge process
|
Committee members,
Below is the long awaited proposed text to specification
committee members requesting them to update their TCK User's guide
to clarify their use of Active or Lazy Consensus resolution.
Please review and we can discuss at our next committee meeting.
Some ideas:
- I've suggested April 1 as an initial deadline. What do we
think about that?
- Should we file issues against each specification project to
track this work?
- Should we expand the To: list?
Happy to take feedback in reply as well as in discussion at the
meeting.
Thanks,
-- Ed
To: jakartaee-spec-project-leads@xxxxxxxxxxx
Subject: Please choose your Test Challenge resolution process
Greetings Jakarta EE Specification Teams
The Jakarta EE Specification Committee is attempting to address
an ambiguity regarding how each Jakarta EE Specification team
expects to handle TCK Challenge issues.
The Specification Committee is requesting that each Jakarta EE
Specification project clearly state their required process for
managing and resolving TCK Challenge issues. Most commonly these
are described in your TCK User Guide, under the section 'Test
Appeals Steps.' This is also described in the Jakarta
EE TCK Process guide if you want to review the goals and
requirements.
There are two primary paths for resolving test challenges. 1)
Active resolution, which requires an explicit approval action from
someone on the specification committer team or 2) Lazy Consensus
resolution, whereby a test challenge issue may become accepted if
no action has been taken for some length of time.
Action Required
Each project must add text describing their specific procedures
and resolution requirements in their TCK documentation (For many
specifications, this will most naturally fit in the TCK Users
Guide under the heading 'Test Appeals Process', perhaps as a new
list item 2 or 3. Additionally, projects must state their selected
resolution process in their top-level project
information file.
Specifically, each project must clarify if lazy consensus is
allow, and if so, how ...
- Is lazy consensus resolution allowed?
- If allowed
- What is the time-frame for lazy consensus resolution.
- What starts this time period (can it be reset?)
- How to raise attention of the specification project
committers, and how to escalate
- What reporting is required for a certification that relies
on an issue covered under lazy consensus resolution
Before the next release of your TCK, please revise the Test
Appeals (or equivalent) documentation in your TCK User Guide to
reflect the choices your project has selected. The Spec. committee
mentors will add a check-list item to ensure these updates are
included in your next balloted release.
Examples
Here are some sample process descriptions your specification
might consider (Please customize these as necessary for your
specification project details)
Active Resolution user guide text
"TCK Challenge and resolution process for <your
specification name>
This specification requires that all test challenges follow the
"Active Resolution" process as described in the
Jakarta EE TCK Process Guide. Please file your challenge
in conformance with "Filing a Challenge" requirements in the TCK
Process Guide. This team will attempt to take timely action but
remember, we are volunteers.
We try to track issues as they are filed but feel free to reach
out to us via <your-specification-dev-list@xxxxxxxxxxx>.
If that fails, you may escalate your issue to the Jakarta EE
Platform Committer list jakartaee-platform-dev@xxxxxxxxxxx.
If it is necessary to escalate further, you may request action
following the Grievance process as described in the Eclipse
Development Process, Handbook under Grievance
Handling. "
Lazy Consensus example user guide text
"TCK Challenge and resolution process for <your
specification process name>
This specification allows for lazy consensus as a resolution
path for TCK test challenges as described in the Jakarta
EE TCK Process Guide. For this specification, test
challenges will be deemed accepted, <indicate your
time-frame> [days or weeks] from the date the test
challenge issue is [filed | last commented on by a
specification team committer]. Please file your challenge
in conformance with "Filing a Challenge" requirements in the TCK
Process Guide. If any specification team member determines that
the challenge requires review it should be marked with the tag
<challenge-review> and it will be resolved under the
'Active Resolution' process as described in the Jakarta EE TCK
Process guide. Generally, once a conversation occurs with a
member of the committer team, the filer should consider that the
challenge will follow the Active Resolution process.
In the event a challenge is approved under lazy consensus, any
vendor implementation Compatibility Certification Request (CCR)
that uses this challenge must include the issue ID along with
the TCK details and test reporting statistics for this
specification, regardless if the CCR is filed to this
specification project issue tracker, or it is filed for any
other specification project issue tracker. Failure to include
this issue reference could result in CCR approval delay.
Once a TCK revision, that includes the resolution of this
challenge is released, it is no longer necessary to include any
additional reference in your CCR.
This specification team tries to track issues as they are filed
but feel free to reach out to us via <your-specification-dev-list@xxxxxxxxxxx>.
If that fails, you may escalate your issue to the Jakarta EE
Platform Committer list jakartaee-platform-dev@xxxxxxxxxxx.
If it is necessary to escalate further, you may request action
following the Grievance process as described in the Eclipse
Development Process, Handbook under Grievance
Handling. "
For the project readme, simplified text may be used. For example,
in the case of Active Resolution only: "All test challenges for
<your-specification-name> must be resolved by Active
Resolution. Please see the TCK Users guide for more details." An
example for Lazy consensus: "Test challenges for <your-specification-name>
may be resolved through Lazy Consensus. Please see the TCK Users
Guide for <your-specification-name> for more details."
For lazy consensus approval, the Specification Committee
recommends a minimum of two weeks (14 days), and a maximum of four
weeks (28 days) for the Lazy Consensus resolution time-frame.
The Specification Team has established an initial target of April
1 for committer teams to review their process and select their
process type. There is no need to generate a new release of your
specification just for this update. However, we would appreciate
your team making the appropriate documentation changes in their
repository as soon as they have reached a decision.
If your team does not respond
If a specification team does not specify the Specification
committee will select the Lazy Consensus option with a 14 day
approval time-frame. The committee will take action to make the
necessary changes to the TCK User's guide and to the project
readme.
As always, we encourage specification teams to be responsive to
vendor inquiries and issues.
The Specification Committee team is available to assist you or
your team if you have any questions.
Thank you
-- Ed Bratt, for the Jakarta EE Specification Committee