2023 Ballot Reconciliation, STU 1 - FHIR IG for Human Services Directories

Overview

This page supports the HL7 FHIR IG for Human Services Directories Ballot Reconciliation (BR) Group and will be used to post information related to the ballot reconciliation process for STU1 of this Implementation Guide.

The page will provide participants links to the various resources used in the ballot reconciliation effort, and recognizes that many participants may not be familiar with HL7 and/or standards development in general.

Please offer any suggestions that will help make this page more useful.

HSS WG Meetings

Ballot Reconciliation Meeting Agendas - Mondays & special Thursday BiWeekly Public Calls  

Ballot Reconciliation Dashboard

• The Human Services Directory Project Dashboard will be used to track progress (No need to log into Jira to view the dashboard from this link).
• You can view all issues from a variety of perspectives (e.g., by grouping, see Gadget – Filter Results: All Issues by Grouping and Reporter)

Issues reviewed, voted & resolution date

Affirmative Technical Corrections Marked Persuasive & Question Answered

Work group decided these issues did not require a vote to apply changes where needed

Assumptions & Process

1. A list of issues for review will be sent in advance attached to an announcement sent to the HSS list serv (hsswg@lists.hl7.org ). The list of issues for review will be sent to the HSS listserv on Tuesdays prior to the following Monday Ballot Reconciliation meeting.
2. Reviewers requesting In-Person resolution will be contacted and their issue(s) scheduled for one of the Monday BR discussions. If Monday’s conflict with their schedules, we’ll suggest they attend an upcoming bi-weekly public HSS call, or come up with a suitable alternative that will be announced on the HSS listserv prior to those discussions.
3. Issues have been tagged/grouped into like subjects, so they can be scheduled for review (and subsequent vote) together.
4. Issues related to terminology (Grouping=code system, valueset) or alignment with the ONC FAST National Provider Directory IG requires coordination and scheduling to ensure broad participation in the discussions.
5. Proposed dispositions / resolutions have been added to most tickets to facilitate the reconciliation process. All issues will be updated in Jira online.
6. Issues entered as Change Requests that are typos, broken links, grammar-related, etc., will be changed to Technical Correction if necessary; and Technical Corrections that are more appropriately issue type Change Requests will also be modified by the project manager
7. If an issue marked as a Question generates a Change Request, a newly "discovered" issue must be created. A discovered item is up to the project sponsors, co-sponsors, and interested parties as to whether they will correct/update/apply the change during the ballot reconciliation process.
8. Jira Issues related to code system and value sets will be added to the Bi-Weekly Thursday HSS Public agenda when discussions may be relevant to other HSS projects and interests.
9. Co-chairs will provide updated instruction as to how to manage Affirmative Technical Corrections marked persuasive on 2/13/23 BR meeting. These issue have been placed back into Triaged status after they had been set to Resolved - Change Required due to misunderstanding the process that HSS would like to follow.
10. For each issue that has been reviewed and the disposition and resolution agreed upon during Monday BR calls, will be voted on during that meeting. Issues that have not been agreed upon will be placed on an upcoming meeting agenda for further discussion.
11. Only when all issues (56) have been approved (reviewed / disposed &/or voted on), will resulting changes be applied to the CI-build.

• When the changes have been applied, an announcement including a link to the CI-build will be sent to the HSS listserv requesting review and feedback by the HSS WG / stakeholders. Once final updates to the IG are complete, a vote to be taken on a future Biweekly HSS Public Call will be scheduled to approve final content for publication.
• There may be interim changes applied to the author's local build demonstrating easy fixes that may be displayed at BR meetings before updates are applied to the CI-build (e.g., important broken links and menu navigation).
• Votes will be recorded as Sub-tasks in Jira issues
• Soliciting volunteers to draft narrative content related to issues requiring elaboration and clarification on the use cases and alignment with other IGs and projects. Any input / advice from SMEs in the issue-domain is welcomed.

Grouping TAGs

• Each JIRA Ticket will include at least one grouping code (reflected on the issues spreadsheets included in the Ballot Reconciliation Meetings table above)
• This list may be expanded as use is identified
• A variety of filters will be developed as work progresses and displayed on the Human Services Directories Ballot Reconciliation Dashboard
• The Human Services Directories Ballot Reconciliation Dashboard will be updated as needed to help reviewers easily identify tickets

List of Reviewers who voted negative

• Negative Voters spreadsheet - will reach out to these individuals to let them know when their issue is scheduled for review. Will adjust the date as needed to accommodate their participation. (A similar process for those who requested in-person resolution, whether Affirmative or Negative voters)

All JIRA Tickets

Communication Channels

Whenever possible, regular communication for this group should be posted to both HL7 listserv (hsswg@lists.hl7.org) and Zulip (https://chat.fhir.org)

• You must be subscribed to the HL7 HSS list to post to this list. (You DO NOT need to be an HL7 member to subscribe to the list.
• The Zulip stream for this IG is: #humanservicesdirectories

Jira Documentation & Help

• Specification Feedback Tutorials

Jira Basics and How-to Webinars

• Jira Basics - General Information

• Searching Jira Issues - JQL and Searching

• Working With Jira Issues - Creating, editing, commenting

FHIR Specification Feedback:

• This page supplements the Specification Feedback page with information that is unique to the FHIR Specification Feedback Jira project.  Be sure to read the base page first.
  • Specification Feedback

Ballot Reconciliation Best Practices

HL7 Balloting

• Jira Ballot Process
• Jira Ballot Administrative Processes: This page describes the steps taken by the Ballot Coordinator in managing the balloting process.
• Reconciliation Spreadsheets - Co-chairs will upload a reconciliation spreadsheet to the HL7 ballot desktop once reconciliation is complete