Difference between revisions of "FHIR Ballot Expectations"

From HL7Wiki
Jump to navigation Jump to search
(Created page with "This is a draft (not yet approved) policy under consideration by the FMG. Balloting is one of the key functions delivered by HL7. The purpose of balloting is to ensure that ...")
 
Line 6: Line 6:
  
 
For this reason, the FMG is instituting the following guidelines for ballot:
 
For this reason, the FMG is instituting the following guidelines for ballot:
1. "for comment" ballots will only be approved in exceptional situations.  In general, content that is not deemed "ready for production" should be reviewed by soliciting WG review through listserv and chat.fhir.org, testing at connectathons and, if need be, holding formal peer reviews.  "For comment" ballots will only be accepted if development cannot proceed without getting answers to questions that cannot be answered without reaching out to the full balloting community.  In this case, the scope of the "for comment" ballot should be clearly limited to those comments.  Ballots scheduled for "STU" ballot will not be dropped to "comment only" ballot.  If content is not ready for ballot review, the ballot should be deferred to a later cycle.
+
 
 +
1. "for comment" ballots will only be approved in exceptional situations.  In general, content that is not deemed "ready for production" should be reviewed by soliciting WG review through listserv and chat.fhir.org, testing at connectathons and, if need be, holding formal peer reviews.  If there is a need to reach a broader community to ask specific questions to allow content to move forward, this can be done through the product director's blog or similar means.  Ballots scheduled for "STU" ballot will not be dropped to "comment only" ballot.  If content is not ready for ballot review, the ballot should be deferred to a later cycle.
  
 
2. Multiple STU ballots prior to publication should be an unusual exception and will require justification to the FMG.
 
2. Multiple STU ballots prior to publication should be an unusual exception and will require justification to the FMG.

Revision as of 21:29, 6 February 2019

This is a draft (not yet approved) policy under consideration by the FMG.

Balloting is one of the key functions delivered by HL7. The purpose of balloting is to ensure that the community targeted by a specification has reviewed the specification and agrees with it and that the specification has appropriately high quality and is appropriate for use.

For this objective to be achieved, it's essential that the community who reviews ballots is used efficiently. The content submitted for ballot must actually be ready for review and reviews must only be sought when necessary.

For this reason, the FMG is instituting the following guidelines for ballot:

1. "for comment" ballots will only be approved in exceptional situations. In general, content that is not deemed "ready for production" should be reviewed by soliciting WG review through listserv and chat.fhir.org, testing at connectathons and, if need be, holding formal peer reviews. If there is a need to reach a broader community to ask specific questions to allow content to move forward, this can be done through the product director's blog or similar means. Ballots scheduled for "STU" ballot will not be dropped to "comment only" ballot. If content is not ready for ballot review, the ballot should be deferred to a later cycle.

2. Multiple STU ballots prior to publication should be an unusual exception and will require justification to the FMG.

3. Content submitted to STU ballot should be considered "ready for production use" by the balloting work group with prior experience at connectathon. The FMG may solicit evidence of adequate connectathon review and/or perform a cursory review of ballot material during the pre-ballot QA period to verify that the submitted content is sufficiently complete and of high-quality. (I.e. there should not be "to do" areas that are relevant for the implementation scope subject to ballot, there should be adequate example instances, etc.)

4. The FMG reserves the right to adjust ballot schedules to balance balloter load. If a large number of ballots targeting the same community are scheduled for ballot in a single cycle, some ballots may be deferred to subsequent cycles

5. Work groups are encouraged to solicit participation during the ballot. Ballots that fail to receive line-item feedback from a sufficient number of commenters may be held back from receiving STU status