Generated from
smart-base/L2/collab/processes/dth-authoring.bpmnbygen-processes-viz.ts— do not edit here. All processes · smart-base processes
DTH authoring
Process_DthAuthoring · advisory · 37 step(s)
Produces a WHO Digital Transformation Handbook (DTH) from its sources to publication, in seven stages that each end in a recorded milestone: initiate (M0 charter), ingest sources into the library (M1 library frozen), outline and scope (M2 outline agreed), structured drafting (M3 zero draft), working-group feedback (M4), public comment (M5 released, M6 dispositioned), and finalise and publish (M7). Milestones are recorded checkpoints, not gates: each is written as a note on the handbook’s epic bean (which milestone, when, evidence), so the site can show stage and progress. Review runs beside drafting as QA, as in smart-guideline-end-to-end.bpmn. Structured drafting uses the smart-base DAK block kinds for personas, scenarios, processes, decisions, data elements, indicators and requirements, and each track calls Process_L2ComponentEditReview, as l2-dak-authoring.bpmn does. Contributor feedback from the contributor log sheet and from GitHub pc: comments lands in one review store. Handbooks ingested from a published WHO PDF (PHC, SC, PC, SFP) enter at stage 1 with their library built and their outline given by the publication; dth-hrh, authored natively, is the pilot. Steps with no platform subprocess are marked as placeholders in their documentation. Empirical content (figures, statistics, country examples) stays as cited narrative blocks and never enters formal content.
How it connects
- Called by: no call activity names this process
- Calls: L2 component edit and review, Publish extracted statements with source links
- Presented on: no docs page section shows this diagram
- Skill:
dth-authoring - Running instances: none recorded
Lanes — who acts
Steps
2 of 37 step(s) carry no documentation — activity-documented lists them.
| step | lane | skill / sub-process | what it does |
|---|---|---|---|
0 · Scope the DTH and place it in the DIIGTask_Scope | DTH lead (programme manager) | content-plan | Name the health-system area, the audience and the DIIG phase the handbook supports, citing the one DIIG phase figure (DIIG section 1.1, Figure 1.1.1). Decide which DTHs and which smart-ra content it builds on. |
Form the TWG; record roles and RACITask_Team | DTH lead (programme manager) | content-plan | Record who is involved and in which role. Roles are named by id, never free text, so they can bind BPMN lanes later. There is no RACI kind; the RACI is a table block. |
Create the DTH repository from the DTH layoutTask_Scaffold | Business analyst | document-structure | Run bun run smart-base/scripts/dth-init.ts with –pins-from an existing DTH’s index.config.json. It writes the instance declaration (folio, glossary, uploads, beans and todos branches), index.config.json (mounting who-iris, smart-base, the platform layers and smart-ra), package.json scripts for the shared checks, the review sheet sync (–sheet) and the files from templates/dth/ (AGENTS.md, session-start hook, PR checks workflow). |
Seed the work planTask_SeedBeans | Work plan (beans) | todo-manager | One bean per stage and per drafting track, children of the handbook’s epic. |
Record milestone M0 · Charter recordedM0 | Work plan (beans) | todo-manager | Milestone: repository, declaration, TWG, roles and RACI exist. Recorded, not enforced. |
1 · Ingest sources into library/Task_Ingest | Librarian | library-ingestion | Every source as received, frozen: WHO publications through who-iris, the TWG outline and workbooks from uploads/. |
Extract L1 from WHO publicationsTask_L1 | Librarian | l1-document-ingestion | Sections, figures, tables and the L1 knowledge graph for each WHO publication the handbook draws on. |
Account for every normative sentenceTask_Coverage | Librarian | l1-coverage | Each normative sentence is captured or excluded; exclusions are signed by a person, never by the agent that proposed them. |
Publish extracted statementsCall_PublishStatements | Business analyst | calls Publish extracted statements with source linkspublish-extracted-statements | Statements extracted from the L1 sources (recommendations, requirements, scenario candidates) are published as pages of the handbook and in the shared l1-extraction viewer, each linked to its library entry and section, once coverage has accounted for every normative sentence and before the library is frozen. The sub-process is core’s, the same for every content type; smart-base supplies the collector (l1-statement-lists) and the handbook only the page look. |
Record milestone M1 · Library frozenM1 | Librarian | todo-manager | Milestone: every source in library/, coverage accounted. Recorded, not enforced. |
2 · Outline chapters against the dth kindTask_Outline | Business analyst | document-structure | Map the outline onto the dth document kind’s sections and report every required section that is missing. dth-hrh’s build_from_outline.py is the only instance; there is no general outline seed. Placeholder: no platform subprocess; done by hand, as for dth-hrh. |
Draft introduction, audience and DIIG alignmentTask_Intro | Business analyst | document-authoring | The three required opening sections of the dth kind: audience and how to use, DIIG and SMART alignment, health programme context. |
Build glossary candidates from the TWG workbookTask_GlossaryCandidates | Terminologist | terminology-management | One SKOS candidate per (concept, source); only a person moves a term to authored. |
List processes, roles, decisions and indicators to modelTask_Inventory | Business analyst | content-plan | The inventory that seeds the structured-drafting tracks: each business process becomes BPMN, each role a structured block, each stated decision rule a DMN table. |
TWG reviews the outlineTask_OutlineReview | TWG and contributors | content-feedback | First contributor-feedback round, through the contributor log sheet and GitHub. |
Record milestone M2 · Outline agreedM2 | TWG and contributors | todo-manager | Milestone: the outline’s round-1 comments are dispositioned. Recorded, not enforced. |
Personas and rolesCall_Personas | Business analyst | calls L2 component edit and reviewl2-dak-authoringl2-component-edit-review | Persona and actor-definition blocks; organisational roles and governance bodies get their own kind once it exists. Calls Process_L2ComponentEditReview. |
User scenariosCall_Scenarios | Business analyst | calls L2 component edit and reviewl2-dak-authoringl2-component-edit-review | User-scenario blocks naming their personas by id. Calls Process_L2ComponentEditReview. |
Business processes · BPMNCall_Bpmn | Business analyst | calls L2 component edit and reviewbpmn-authoringl2-component-edit-review | One BPMN per business process; every lane bound to a persona or role id. Calls Process_L2ComponentEditReview. |
Decision tables · DMNCall_Dmn | Business analyst | calls L2 component edit and reviewdmn-authoringl2-component-edit-review | Only rules the text states. A decision the text names without a rule is recorded as a decision point, not filled in. Calls Process_L2ComponentEditReview. |
Data elements, indicators, requirementsCall_Data | Business analyst | calls L2 component edit and reviewl2-dak-authoringindicator-extractionl2-component-edit-review | data-element, indicator, functional and non-functional requirement blocks, with their fields as data rather than Markdown tables. Calls Process_L2ComponentEditReview. |
Planning steps per chapterCall_Steps | Business analyst | calls L2 component edit and reviewdocument-authoringl2-component-edit-review | Each chapter’s inputs, steps, resources, outputs, risks and mitigations as the shared step table. Calls Process_L2ComponentEditReview. |
Link to smart-ra ArchiMateCall_Archimate | Business analyst | calls L2 component edit and reviewarchimate-modelsl2-component-edit-review | Every block that names an architecture element links to its smart-ra element or view; new elements go to smart-ra, not the handbook. Placeholder: no platform subprocess; done by hand, as for dth-hrh. Calls Process_L2ComponentEditReview. |
Link glossary to smart-ra SKOSCall_Glossary | Business analyst | calls L2 component edit and reviewterminology-managementl2-component-edit-review | Each handbook term is exactMatch, closeMatch or narrower to a smart-ra concept; conflicts are raised as issues on smart-ra. Calls Process_L2ComponentEditReview. |
Validate the draftTask_Validate | Business analyst | content-validate | Every structured block validates against its kind; required dth sections present; no unlinked architecture names; no empirical claims in formal content. |
Architect group and handbook owners reviewTask_ArchReview | Architect group and handbook owners | content-review | Runs beside validation, as QA. New kinds and shared schemas are reviewed here before they are built. |
Record milestone M3 · Zero draftM3 | Business analyst | todo-manager | Milestone: every required section drafted and every structured block validates. Recorded, not enforced. |
4 · Comment via contributor log sheet or GitHub pc:Task_Comments | TWG and contributors | content-feedback | The contributor log (Google Sheet) and pc: lines on GitHub issues and PRs. |
Import into review/wg-comment and form change setsTask_Import | Editor | public-comment | public-comment import –store review/wg-comment; change sets group comments that change the same text. |
Record milestone M4 · Working-group draftM4 | Editor | todo-manager | Milestone: all working-group comments dispositioned. Recorded, not enforced. |
5 · Open public commentTask_OpenPublic | Editor | public-comment | A separate store, review/public-comment, and the public-comment review sheet. |
Record milestone M5 · Public draft releasedM5 | Editor | todo-manager | Milestone: the public draft is out for comment. |
Public commentsTask_PublicComments | TWG and contributors | content-feedback | — |
Disposition comments and apply change setsTask_Disposition | Editor | public-comment | Changes to structured content go back through its kind’s edit-and-review subprocess. |
Record milestone M6 · Comments dispositionedM6 | Editor | todo-manager | Milestone: every public comment dispositioned. |
6 · Editorial, voice and translation QATask_Qa | Editor | quality-control | The DTH voice (smart-base skills/voices/who-digital-transformation-handbook), figures and translations. |
Publish the handbookTask_Publish | Publication manager | document-publishing | — |
Decisions
1 of 1 decision(s) carry no documentation — gateway-documented lists them.
| decision | what decides it | branches |
|---|---|---|
All working-group comments dispositioned?GW_WgDone | — | yes → Record milestone M4 · Working-group draft no: revise → GW_DraftMerge |