FHIR Connectathon Track Process

This page describes the process used to select and approve the implementation tracks at the FHIR connectathons held in conjunction with HL7 working group meetings. (These rules do not apply to connectathons organized by other organizations and may not always apply to non-WGM connectathons organized by HL7 international.)

The guidelines provided here are DRAFT and are not yet in force

Objectives

FHIR is becoming more popular. Testing as part of a connectathon is a pre-requisite for resources and implementation guides progressing up the FHIR Maturity Model. As well, connectathons are an excellent way to increase the visibility of resources, profiles and implementation guides. These factors are resulting in increasing pressure on the number of tracks to be held. At the same time, room size and resources to support coordination as well as limits on what key participants (server providers, EHR vendors, etc.) can reasonably accomplish means that there is an upper limit to how many tracks can reasonably be hosted within a single connectathon event.

The process described below is intended to ensure the following:

• The process for selecting tracks hosted at connectathons is open and transparent
• Connectathon tracks are sufficiently well-defined to support a quality connectathon experience for implementers
• Connectathon tracks meet the needs of the implementer community and the development of the FHIR specification by prioritizing higher-priority topics

Process

The connectathon track selection process has 3 phases - solicitation of interest, preliminary approval and prioritization and final selection.

Solicitation of Interest

This process should be initiated within the 2 weeks following an HL7 Working Group Meeting

The FMG will send out a solicitation of interest for connectathon tracks to the FHIR list server, co-chairs list server and FHIR Implementer's Skype Chat. The solicitation may also be distributed through other mechanisms (blogs, FHIR.org, etc.)

The solicitation will provide a deadline for initial submissions with a period not less than 2 weeks. The solicitation will include a reference to the requirements on this wiki page and provide a mechanism to submit proposed connectathon tracks.

Connectathon proposals will include:

• What resources and/or implementation guide components will be exercised by the track
• Name, email and (ideally) Skype id of the individual who will commit to attending the connectathon to help manage the track
• A list of the roles (conformance statements) a connectathon participant can take on, including a description of the capabilities each role must have
• An initial list of implementers who intend to participate in the track and which role(s) they intend to be able to exercise
• A detailed description of the test scenarios indicating what each role participant would be expected to do, including distinguishing optional and mandatory steps
• Any information around implementer and/or work group requirements/timelines that might impact the prioritization of the track
• If possible, a set of TestScript instances formally describing the tests to be performed, including sample data necessary for executing the tests. If this is not possible, the proposal must include a commitment to have TestScripts in place prior to the final track approval deadline or must indicate why TestScripts are inappropriate for this track

Preliminary Approval and Prioritization

Upon the completion of the submission period, the FMG will review candidate track proposals and prioritize them base on the following criteria:

• Proposals will not be considered if no individual is committed to attend the connectathon to help manage the track
• Proposals for tracks that are needed to evaluate content scheduled for ballot will receive highest priority
• Proposals with evidence of significant implementer interest will be prioritized over those with less or no such evidence
• Proposals that exercise capabilities not tested in prior connectathons will receive priority over those that have already been tested

Exception: Some tracks will be designated by the FMG as "ongoing" tracks, meaning they will be exercised as part of all connectathons. This will include the entry-level "Patient" track as well as other tracks that are considered to provide essential infrastructure to other tracks. (These tracks must still meet the requirements of having a designated track lead and complete TestScripts.)

Upon completion of their review, the FMG will produce a preliminary list of connectathon tracks, ranked by priority. This list will be provisional as not all tracks will be included on the final list. Approval will be dependent on the evaluation in the final approval step (below).

This preliminary list of tracks will be distributed to the FHIR list server and implementer Skype chat along with a request for implementers to sign up to tracks on the Connectathon Google document (with an email alternative for those where Google access may be problematic).

Final Approval

Approximately 6 weeks prior to the connectathon, a "frozen" versions of the FHIR specification will created for Connectathon use. At this point the FMG will review the state of all preliminary tracks including the degree of implementer commitment and the state of the formal Test Scripts. The FMG will evaluate:

• whether at least one implementer has signed up for each role necessary to exercise the track
• whether the TestScripts are sufficiently complete as to support automated testing of the server portions of the track and to guide execution of the client side of the track. (In some cases, TestScripts may not be applicable, depending on what the track is testing.)
• whether the coordinator for the track has registered to attend the connectathon

Tracks that meet these requirements will be approved as an official part of the connectathon. Other tracks can potentially proceed as part of the "experimental" track but will not be officially announced as part of connectathon communications.