Merge pull request #1 from WorldHealthOrganization/regenstrief-ocl

Transferring files from personal GitHub
WorldHealthOrganization · Jan 16, 2025 · 01cfe11 · 01cfe11
2 parents b24e013 + 3e9381d
commit 01cfe11
Show file tree

Hide file tree

Showing 17 changed files with 483 additions and 11 deletions.
diff --git a/input/images/1728302475032.png b/input/images/1728302475032.png
diff --git a/input/images/1728302521693.png b/input/images/1728302521693.png
diff --git a/input/images/1728302543511.png b/input/images/1728302543511.png
diff --git a/input/images/1728302561394.png b/input/images/1728302561394.png
diff --git a/input/images/1728302571960.png b/input/images/1728302571960.png
diff --git a/input/images/1728302589232.png b/input/images/1728302589232.png
diff --git a/input/images/1728302601944.png b/input/images/1728302601944.png
diff --git a/input/images/1728302617005.png b/input/images/1728302617005.png
diff --git a/input/images/1728302632280.png b/input/images/1728302632280.png
diff --git a/input/images/1728302658041.png b/input/images/1728302658041.png
diff --git a/input/images/1728302669099.png b/input/images/1728302669099.png
diff --git a/input/pagecontent/DAK-DD-Authoring-Guide.md b/input/pagecontent/DAK-DD-Authoring-Guide.md
diff --git a/input/pagecontent/TerminologyPersonas.md b/input/pagecontent/TerminologyPersonas.md
@@ -0,0 +1,7 @@
+### Personas related to Terminology Management
+
+| Name                     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Different names (if relevant)         | **[International Standard for Classification of Occupations code (if relevant](https://www.ilo.org/public/english/bureau/stat/isco/isco08/index.htm)** |
+| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| SMART Guideline Author   | SMART Guideline Authors work broadly to translate clinical guidelines from WHO into artifacts that can be implemented into clinical systems in a clear and consistent manner. They are responsible for: Analyzing WHO clinical guidelines and translate them into computable artifacts; Developing FHIR profiles representing guideline data structures and constraints; Managing versioning of guideline artifacts as clinical guidelines evolve; Collaborating with health IT implementers on practical application | N/A                                   | N/A                                                                                                                                                       |
+| Clinical Systems Analyst | Clinical Systems Analysts primarily implement the guidelines, recommendations, tools, and standards of WHO SMART Guidelines into point-of-care systems. They are responsible for: Analyzing WHO guidelines and other health standards; Translating clinical requirements into technical specifications; Developing or customizing health information systems; Ensuring compliance with relevant health standards, directives, and initiatives; Collaborating with healthcare providers to optimize workflows       | Systems Analyst<br />Business analyst | 2511                                                                                                                                                      |
+| Health Data Coder        | A Health Data Coder primarily works with local patient and clinical data, assigning codes that align with international standards. Their goal is to quickly understand the recommended data elements, codes and mappings to reference vocabularies for the selected WHO guidance.                                                                                                                                                                                                                                    | Coding clerk<br />Data clerk          | 4413                                                                                                                                                      |
diff --git a/input/pagecontent/index-dak.md b/input/pagecontent/index-dak.md
@@ -0,0 +1,59 @@
+<!---Note: Remove this below div element for releasing, only to maintain for main branch -->
+<div>
+<p> This DAK and set of implementation tools are still undergoing development. </p>
+<p> Content is for demonstration purposes only. </p>
+</div>{:.stu-note}
+
+
+### Summary 
+This WHO <mark>[insert health domain here]</mark> DAK <mark>add content here</mark>
+
+### L1 Narrative guidelines
+<mark>[insert content here]</mark>
+
+### L2 Operational guidelines
+The L2 <mark>[insert health domain here]</mark> Digital adaptation kit publications and implementations tools can be found here:
+
+<!-- insert links inside the parentheses below --->
+- [Published DAK Document]()
+
+- [Link to core data dictionary]()
+
+- [Link to decision support logic]() 
+
+- [Link to scheduling logic]() 
+
+- [Link to indicators table]()
+
+- [Link to functional and non functional requirements]()
+
+### L3 Machine readable guidelines
+The L3 FHIR Implementation Guide for the <mark>[insert health domain here]</mark> SMART Guidelines is yet to be published. Links will be published here as soon as they're available.
+
+### L4 Executable guidelines
+Reference implementations representing the L4 layer for the <mark>[insert health domain here]</mark> SMART Guidelines are not yet available. Links will be published here as soon as they're available.
+
+### L5 Dynamic guidelines
+Content representing the L5 layer for the <mark>[insert health domain here]</mark> SMART Guidelines are not yet available. Links will be published here as soon as they're available.
+
+### News
+
+### Contact Us
+<p>Please let us know about your experience in using the DAK and questions you may have by contacting us at <a href= "mailto:[email protected]?subject = DAK Feedback">[email protected]</a></p>
+
+### License
+This work is licensed under a
+[Creative Commons Attribution-NonCommercial-ShareAlike 3.0 IGO License][cc-by].
+
+[![CC BY 3.0][cc-by-image]][cc-by]
+
+[cc-by]: http://creativecommons.org/licenses/by-nc-sa/3.0/igo/
+[cc-by-image]: https://i.creativecommons.org/l/by-nc-sa/3.0/igo/88x31.png
+[cc-by-shield]: https://img.shields.io/badge/License-CC%20BY%203.0-lightgrey.svg
+
+### Providing Feedback
+{% include feedback.md %}
+
+<!-- for main branch of DAK repos only, remove while releases -->
+### Disclaimer
+The specification herewith documented is a demo working specification and may not be used for any implementation purposes. This draft is provided without warranty of completeness or consistency and the official publication supersedes this draft. No liability can be inferred from the use or misuse of this specification or its consequences.
diff --git a/input/pagecontent/index-ig.md b/input/pagecontent/index-ig.md
@@ -1,21 +1,47 @@
-### Overview
+This WHO <mark>[insert health domain here]</mark> Implementation Guide details how to use Health Level 7 (HL7) Fast Healthcare Interoperability Resources (FHIR) for consistent digital representation of <mark>[insert health domain here]</mark> services.
 
-This implementation guide contains terminology artifacts and resources for use in all WHO SMART Guidelines implementation guides.
+<div>
+<p> This implementation guide and set of artifacts are still undergoing development. </p>
+<p> Content is for demonstration purposes only. </p>
+</div>{:.stu-note}
 
-See the [SMART IG Starter Kit](https://smart.who.int/ig-starter-kit/) for more information on building and using WHO SMART Guidelines.
 
-### Dependencies
+### Summary 
+This implementation guide includes a machine-readable representation of WHO guidelines for <mark>[insert health domain here]</mark>, as documented in the WHO Digital Adaptation Kit for <mark>[insert health domain here]</mark> (link forthcoming) and explicitly encodes computer-interoperable logic, including data models, terminologies, and logic expressions, in a computable language to support implementation of <mark>[insert health domain here]</mark> use cases by WHO Member States.
 
-{% include dependency-table-short.xhtml %}
+The guide is part of the [WHO SMART Guidelines approach](https://www.who.int/teams/digital-health-and-innovation/smart-guidelines) to support countries to integrate WHO global health and data recommendations into digital systems accurately and consistently. It defines a series of FHIR Resources, Profiles, Extensions, and Terminology based on the WHO <mark>[insert health domain here]</mark> Digital Adaptation Kit (link forthcoming). 
 
-### Cross Version Analysis
+Supporting guidance, recommendations, resources, and standards are included in the <a href="references.html">References</a> and <a href="dependencies.html">Dependencies</a>.
 
-{% include cross-version-analysis.xhtml %}
+### About this implementation guide
 
-### Global Profiles
+This implementation guide is broken into the following levels of [knowledge representation](https://hl7.org/fhir/uv/cpg/documentation-approach-06-01-levels-of-knowledge-representation.html):
+- <a href="index.html">Home</a> - contains references to the guidance, guidelines, policies and recommendations underpinning this implementation guide.
+- <a href="business-requirements.html">Business Requirements</a> - contains the requirements for this implementation guide including the definition of key concepts, use cases, and a data dictionary.      
+- <a href="data-models-and-exchange.html">Data Models and Exchange</a> - contains the data models and data exchange protocols with actors and transactions defined.
+- <a href="deployment.html">Deployment Guidance </a> - contains relevant technical specifications and guidance, testing resources, reference implementation materials, and supporting guidance for adaptation to local contexts.
 
-{% include globals-table.xhtml %}
+This guide is prepared to facilitate digital implementation of WHO <mark>[insert health domain here]</mark> guidelines by providing FHIR-based computable representations of and implementation guidance for using the key components of the WHO <mark>[insert health domain here]</mark> digital adaptation kit (DAK):
 
-### IP Statements
+* Health Interventions & Recommendations
+* Generic Personas
+* User Scenarios
+* Business Processes & Workflows
+* Core Data Elements
+* Decision Support Logic
+* Indicators & Monitoring
+* Functional & Non-functional Requirements
 
-{% include ip-statements.xhtml %}
+This guide is a companion to the Digital Adaptation Kit (DAK) and should be used side-by-side with it. Implementers are strongly encouraged to make use of the Digital Adaptation Kit. The focus of this guide is on the explanation and use of the computable artifacts.
+
+This guide assumes use of the following resources: 
+* [IPS Patient](http://hl7.org/fhir/uv/ips/StructureDefinition/Patient-uv-ips)
+* [CPG ActivityDefinitions](https://hl7.org/fhir/uv/cpg/artifacts.html#activitydefinition-index)
+
+- For a complete listing of the artifacts defined in this implementation guide, refer to the [Artifact Index](artifacts.html).
+- A complete offline copy of this implementation guide can be found on the [Downloads](downloads.html) page.
+
+- This Implementation Guide makes use of [Clinical Quality Language](https://cql.hl7.org/) for the decision support artifacts including the PlanDefinitions and Measures. They are used to express how a calculation should occur and can be used with a CQL engine in order to process the decision or indicator directly from the applicable FHIR resources. Links to this specification, the FHIR Clinical Practice Guidelines Speciciation, and other helpful resources can be found in the Support dropdown.
+
+### Disclaimer
+The specification herewith documented is a demo working specification and may not be used for any implementation purposes. This draft is provided without warranty of completeness or consistency and the official publication supersedes this draft. No liability can be inferred from the use or misuse of this specification or its consequences.
diff --git a/input/pagecontent/index.md b/input/pagecontent/index.md
@@ -1,2 +1,5 @@
+<!-- please keep only this for L2 DAK -->
+{% include index-dak.md %}
+
 <!-- please keep only this for L3 FHIR IG -->
 {% include index-ig.md %}
diff --git a/sushi-config.yaml b/sushi-config.yaml
@@ -24,6 +24,8 @@ meta:
 pages:
   index.md:
     title: Home
+  DAK-DD-Authoring-Guide.md: DAK Data Dictionary Authoring
+  TerminologyPersonas.md: Terminology Personas
   changes.md:
     title: Changes
   downloads.md: 
@@ -33,6 +35,9 @@ pages:
 
 menu:
   Home: index.html 
+  DAK Data Dictionary Authoring:  
+    Overview: DAK-DD-Authoring-Guide.html # Might try removing hyphens
+    Personas: TerminologyPersonas.html # Might try removing spaces
   Downloads: downloads.html
   Indices:
     Artifact Index: artifacts.html