Implementation Guide (IG) Readability
Requirementsβ
A FHIR implementation guide MUST include documentation that helps people understand the API.π‘
An Implementation Guide SHOULD have the following:
Home pageβ
A clear high level description of the implementationπ‘, including:
- The name of the system
- Who created it
- What itβs for
- Who is expected to use it
- What data is involved at a high level
- What FHIR resources are used (unless this is a large list e.g. the IPS, then this detail should be left to another page)
- A description of the tabs/other pages available in the IG
- Contact details for responsible parties
Health information contextβ
A FHIR IG SHOULD provide Health Information Context:π‘ This describes the 'business' view for an IG and should contain content that describes the set of informational concerns or problems that the implementation is trying to address. It should include the relevant history, context, and description of the problem domain and solution.
Use casesβ
A FHIR IG SHOULD demonstrate Use Cases:π‘ In this context use cases means user and system interactions that surround or motivate integration between a health application and the FHIR API. At minimum integration use cases can simply be described, or may be illustrated using UML sequence diagrams where orchestration involves multiple health systems and the FHIR API.
Onboardingβ
This section describes how consumers of the implementation can gain access to the API, and should include at least the following:π‘- Who is eligible
- What is the process for onboarding
- How to start that process
- Links to required information or services involved in the process
- Any compliance or conformance testing required for service consumers
- Contact information
Profilesβ
Your profile page SHOULD contain a comprehensive description of the resource and how it is used in this implementation.π‘ This should include a high-level description of the information it contains and the boundaries (what it might not contain) and its relationship to other resources in the implementation (where there are references or otherwise).
Must Supportβ
Where your API has profiled 'Must Support' fields, you SHOULD have a visible page (ideally in the top level of the menu) describing what it means to "support" the element or resource type in this solution domain.π‘ Any instances of the following requirements MUST be made clear in this section:
- The system must be able to store and retrieve the element.
- The system must display the element to the user for clinical safety reasons.
- The system must allow submission of the element in an update or resource create to meet business or regulatory requirements.
- The element must be taken into account when performing clinical decision support, calculations or other processing.