SMART Guidelines Starter Kit
1.1.0 - ci-build
SMART Guidelines Starter Kit, published by WHO. This guide is not an authorized publication; it is the continuous build for version 1.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/WorldHealthOrganization/smart-ig-starter-kit/ and changes regularly. See the Directory of published versions
The following sections provides a checklist to review to ensure that a SMART Guidelines Implementation Guide has the expected content and level of quality.This checklist is broken up according four layers of knowledge representation.
Checklist for narrative content relating the guidance, guidelines, policies and recommendations underpinning this Implementation Guide.
Section in IG | Required | Description | Expected Artifacts | Acceptance Criteria |
---|---|---|---|---|
Home Page.Summary | Yes | Linkage to the primary L1 and L2 content that underpins this Implementation Guide | URL links on the home page to relevant guidance documents and a brief description of the relevance of the document to this Implementation Guide | Links exist on the home page |
Home Page.Providing Feedback | Yes | Instructions to describe how feedback can be shared for all knowledge layers in the Implementation Guide | At the minimum, an email address exists to send feedback, and/or a feature to provide feedback can be provided per section shall exist | Section exists on the home page |
Home.Adapting Guidelines for Country use | Yes | Guidance to countries on adapting the Implementation Guide for making adaptations for country use | adapting_guidelines.xml | Page exists under the home dropdown menu |
Checklist for semi-structure content relating to business requirements, definitions of key concepts, user personas, use cases, and data dictionaries underpinning the Implementation Guide.
Section in IG | Required | Description | Expected Artifacts | Acceptance Criteria |
---|---|---|---|---|
Business Requirements.Concepts | Yes | A list of terms and key concepts introduced in the L2 or in the Implementation Guide | concepts.xml | A page for key concepts under business requirement exists |
Business Requirements.Generic Personas | Yes | Depiction of end-users and related stakeholders as introduced in the L2 | Personas.xml | A page for Personas under business requirement exists |
Business Requirements.Use Cases | Yes | User scenarios depicting how different personas will interact in a typical workflow along with use cases listed as introduced in the L2 | usecases.xml | A page for User Scenarios and Use Cases under business requirement exists |
Business Requirements.Business Processes | Yes | Depiction of business processes as visual workflows as introduced in the L2 | business_process.xml | A page for depicting the visual business processes exists |
Business Requirements.Data Dictionary | Yes | Data dictionary with detailed data specifications as introduced in the L2 | dictionary.xml | A page for data dictionary under business requirements exists |
Business Requirements.Decision-support Logic | Yes | Decision-support logic and algorithms as introduced in the L2 | decision_support.xml | A page for decision-support logic under business requirements exists |
Business Requirements.Indicator and Performance Metrics | If indicators are defined | Core set of indicators and performance metrics as introduced in the L2 | indicators.xml | A page for the indicators table under business requirements exists |
Business Requirements.Functional Requirements | Yes | List of core functions and capabilities the system must have to meet the end-users’ needs and achieve tasks within the business process. | functional.xml | A page for functional requirements under business requirements exists |
Business Requirements.Non-functional Requirements | Yes | List of capabilities the system must have as introduced in the L2 | nonfunctional.xml | A page for non-functional requirements under business requirements exists |
Checklist for structured content relating to data models, data exchange protocols with actors and transactions defined which are defined in the Implementation Guide.
Section in IG | Required | Description | Expected Artifacts | Acceptance Criteria |
---|---|---|---|---|
Data Models and Exchange.System Actors | Yes | List and description of software or human entities that interact with the system derived from business requirements defined in L2.Actors and Transactions should be defined for a general systems architecture that applies over multiple country implementations and leverages OpenHIE architecture concepts.Systems managing clinical and patient information shall be expected to interact with a shared health record, laboratory information system or a longitudinal health record as appropriate and be expected to synchronize with data collected in a clincal encounter | Actors | Actors defined are tied to and derived from L2, with a definition of who the actor is and what they do in the system at a minimum |
Data Models and Exchange.Sequence Diagram | Yes | A sequence diagram depicting the interactions between system actors in sequence derived from business process in L2 | sequence_diagram.xml | A sequence diagram exists that shows the system interactions |
Data Models and Exchange.Transactions | Yes | Defined list of system transactions at an atomic level for each actor along with narrative, capability statements, structure definition, questionnaires, document bundles and composition. It can also refer to transactions in other Implementation Guides | Capability Statement, Structure Definitions, Questionnaires, Document Bundles and Composition | Artifacts exist and are defined for each actor in terms of their roles and responsibilities |
Indices.Artifacts Summary.Structures:Logical Models | Yes | Structure Definition resource describing data element definitions and their associated rules of usage derived from data dictionary in L2 | Structure Definition | A logical model for each core data set/data dictionary asset mentioned in the L2 exists |
Data Models and Exchange.Indicators and Measures | If indicators are defined | Thematic list of indicators defined in the IG that link to L1 and L2 guidance documents. The IG shall maintain the reference numbers as defined in the L1 and L2 for the indicators. | Measures, Value Sets | Measure is defined according to the Data Sharing Specification (DSS) described in the IHE White Paper for EXtracting Indicators from Person Level Data. The Mobile Aggregate Data Exchange (mADX) profile is leveraged. |
Indices.Mappings | Yes | Relationship to IPS: The logical model defined in the IG shall be mapped to the IPS data set. | Structure Maps | For each data set defined in the IG there shall be a related mapping which uses IPS as source and the data set as target in the structure map |
QA Report | Yes | Artifact ProfilesAll artifacts defined in the IG shall conform to the Shareable, Publishable and Computable profile. | StructureDefinition, ValueSet, CodeSystem, Library, ActivityDefinition, PlanDefinition, Measure, Questionnaire, GraphDefition, Metric, ImplementationGuide | QA report shows no errors for artifacts missing shareable, publishable or Computable profile conformance |
QA Report | Yes | Artifact ProfilesValueSet and Library artifacts if defined shall conform to the Executable profile | ValueSet, Library | QA report shows no errors for ValueSet and Library artifacts missing executable profile conformance |
Data Models and Exchange.Codings | Yes | ValueSets defined shall map to ICD-11 or one of the WHO Family of International Classifications (FIC), if the content exists. If not an openly available reference vocabulary such as LOINC shall be used | ValueSet, ConceptMaps, CodeSystems | QA report shows no errors for ValueSet and Library artifacts missing executable profile conformance |
Checklist for executable content supporting guidance for adaptation to local contexts in the Implementation Guide.
Section in IG | Required | Description | Expected Artifacts | Acceptance Criteria |
---|---|---|---|---|
Deployment.Testing | Yes | Example Data shall be represented via example resources for each of the UN Languages | FSH files or FHIR Resources, and examples listed under the example tab of resourcesQA Report | For every non abstract profile there should be an example resource for each of the UN Languages |
Deployment.Testing | No | Test Definitions are written along with brief description of the scope of testing covered. | Gherkin .feature files | Acceptance Criteria is written for each test definition.All PlanDefinitions and Measures should have defined Test Cases |
Deployment.Test Data | No | Test data represented as resources for the test definitions | Synthea scripts of FSH files | All CQL libraries have associated test libraries |
Deployment.Reference Implementations | No | Links to list of reference implementations | Links to software download, source code, install documentation, user manuals and such | |
Downloads | ? | All IG Content shall be available to download as zip or npm package | Zip, npm package | Links to npm package are available |
Checklist applicable for the Implementation Guide in general.
Section in IG | Required | Description | Expected Artifacts | Acceptance Criteria |
---|---|---|---|---|
Home Page | Yes | Status and maturity level of the Implementation Guide is based on the CMM (Capability Maturity Model) framework and the intention is to give implementers a sense of how mature the Implementation Guide is.TODO: define maturity levels such as 'draft', 'candidate recommendation/STU', 'published/recommendation/normative'. | Disclaimer notice indicating the maturity level of the implementation guide | Maturity level is indicated in the 'STU Note' block quote on the home page of the Implementation Guide. |
Home Page and Footer | Yes | Versioning policy of the Implementation Guide is based on FHIR versioning and Semantic versioning. Each IG version s hall be identified by a string composed from 4 parts: major.minor.patch-label. | STU Note and the footer display the versiono of the IG | Criteria#1: If any artifact under the IG undergoes a change, then the IG must undergo a version update that follows semantic versioning. Criteria#2: If the IG version is updated then all the artifacts under it inherit the version number and get updated as well. |
Yes | Shall follow all HL7 FHIR Implementation Guide Publishing Requirements | |||
Footer | Yes | The IG publisher reports many errors in the file qa.html. This shall be published so that any reviewer of the specification can check the status of the IG. | qa.html | QA Report has no errors or unsuppressed warnings. All suppressed warnings must have a reasonable explanation for suppression |
Home.Changes | Yes | A page that describes all version releases with a brief description of major changes | changes.xml | A page for versioning and release notes exist |