carecommons/smart-hiv-l2-contextualization

Guidance for adapting WHO HIV SMART Guidelines L2 artifacts (decision tables + indicators) to a national context — Ethiopia worked example. # SMART HIV — L2 Contextualization Guidance **▶ View online:** carecommons.github.io Hands-on guidance for **adapting WHO HIV SMART Guidelines L2 artifacts** — the **decision-support tables** and **indicators** of the Digital Adaptation Kit (DAK) — to a national context, using **Ethiopia** as the worked example. It is built for national HIV program + digital-health teams and the **L2/L3 working groups** doing the adaptation. ## Start here - **Walkthrough (tutorial)** — read this first. How to read each DAK annex, the authoring conventions, and two worked examples (a decision table and an indicator) carried end to end. (PDF · markdown source) > PDFs (tutorial + both cheat sheets) are **regenerated by the Pages CI on every deploy** from the HTML — they aren't committed to the repo. ## Keep beside the annexes (one-page cheat sheets) - **Decision-support table** — PDF · HTML - **Indicator** — PDF · HTML ## Reference - **Source reference** — the detailed method, conventions, and worked artifacts, with citations. ## How to use 1. Read the **walkthrough** to learn the adaptation loop: *locate → read the WHO logic → find the national divergences → author in the WHO format → check → record provenance → hand to L3.* 2. Keep the matching **cheat sheet** open while you author a decision table or an indicator. 3. Use the **source reference** for the detailed conventions and the fully worked examples. ## Useful links & references **Start with these four:** | Link | What it is | |------|------------| | **IG Starter Kit** | The WHO method for authoring DAK artifacts — this guidance follows it. | | **WHO HIV DAK** | The L2 publication and web annexes — the source you adapt. | | **HIV L3 IG (rendered)** | Browse the WHO decision-support logic and indicators online. | | **Community of Practice** | Weekly calls and the `who-smart-guidelines` stream on chat.fhir.org. | More references — Starter Kit pages, other WHO guidance, and …