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 for FHIR IG Human Services Directories Weekly Monday Meetings | Agenda items will be added to the Thursday Bi-Weekly Public HSS WG Call as needed when of interest to the entire HSS work group |
---|---|
Monday weekly @ 2:00 PM ET Meeting Link: https://hl7-org.zoom.us/j/9496845038 | Thursdays every other week @ 3:00 PM ET Meeting Link: https://hl7-org.zoom.us/j/9496845038 |
Ballot Reconciliation Meeting Agendas - Mondays & special Thursday BiWeekly Public Calls
Topic | Issues Spreadsheet | Details | |
---|---|---|---|
Jan 30, 2023 | Set the stage for Ballot Reconciliation |
| |
Feb 6, 2023 | Issues Review & Disposition
| Issues - 2023 02 06 |
|
Feb 13, 2023 | Issues Review & Disposition | Issues - 2023 02 13 |
|
March 6, 2023 | Use Cases | Use Case Related (G. Bloom)
Other Issues |
|
March 13, 2023 | Issue Type change to FHIR-39885 & Search Parameters/Capability Statement |
|
|
THURSDAY - March 16, 2023 These issues will be reviewed the Thursday HSS Bi-Weekly Public Call @ 3:00 PM Eastern instead of the regular Monday weekly BR call. HL7 Conference Call Zoom Meeting Link: | Alignment to other FHIR specifications | Hans Buitendijk
Greg Bloom |
|
THURSDAY - March 23, 2023 | Alignment/Naming Convention continued from March 16, 2023 | Resolve - Duplicate issues (FHIR-39849) – voted on 2/13/23
Rescheduled/additional issues
|
|
March 27, 2023 | Continue Issues scheduled for 3/23/23 |
|
|
April 3, 2023 | Meeting cancelled | ||
April 10, 2023 | Continue reviewing outstanding issues | Hans Buitendijk Saul Kravitz
Chirag Bhatt
|
|
April 17, 2023 & April 24, 2023 | Meetings cancelled | ||
May 1. 2023 | Outstanding issues (other than Terminology-related | Hans Buitendijk Gay Dolin Himali Saitwal |
|
May 8, 15, 22, 2023 | Meetings cancelled until after the May WGM & Terminology Issues 5/25 meeting | ||
Thursday, June 22, 2023 HSS WG Biweekly Mtg (postponed from 5/25) Zoom Meeting Link: | Terminology Issues | Agenda: Terminology Jira Issues - Discussion & Vote on Issues during HSS WG Biweekly Public Call
|
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
Issue Key | Summary |
---|---|
FHIR-39682 | Update IG Visuals |
FHIR-39683 | This IG need technical editing |
FHIR-39781 | Show Usage link under Section 1.6.4 IP Statements doesn't resolve correctly |
FHIR-39848 | Typos |
FHIR-39879 | Figure 1 - subscript figure title extra? |
FHIR-39880 | Figure 2 Missing? |
FHIR-39881 | Figure Headings vary |
FHIR-39882 | Most images are fuzzy and/or too large |
FHIR-39883 | Capability Statement in red header ribbon does not go to page that clearly identifies Capability statement |
FHIR-39887 | Differential tables don't look correct |
FHIR-39891 | Jira Spec file does not align well with the IG |
FHIR-40050 | Rearrange artifact page for better ordering |
FHIR-40051 | Download files need to be updated |
FHIR-40054 | Why can't a consumer app query the directory - seems like it should be able to |
FHIR-40073 | Spell out LTSS |
FHIR-40134 | correction language intent |
Request clarification on the relationship between this IG and Gravity | |
FHIR-40146 | Grammar in phrase |
FHIR-40147 | Grammar in phrase |
FHIR-40148 | Grammar in phrase |
FHIR-40150 | Grammar in phrase |
FHIR-40152 | Short name clarification |
FHIR-40154 | Grammar in phrase |
FHIR-40156 | Grammar in phrase |
FHIR-40159 | Grammar in phrase |
FHIR-40162 | Grammar in phrase |
FHIR-40169 | Repeated Information |
Assumptions & Process
- 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.
- 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.
- Issues have been tagged/grouped into like subjects, so they can be scheduled for review (and subsequent vote) together.
- 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.
- Proposed dispositions / resolutions have been added to most tickets to facilitate the reconciliation process. All issues will be updated in Jira online.
- 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
- 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.
- 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.
- 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.
- 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.
- 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
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.
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