Skip to content

docs: complete DHIS2 immunization tutorial - #650

Merged
jeremi merged 1 commit into
mainfrom
agent/fix-dhis2-tutorial-openapi
Aug 6, 2026
Merged

docs: complete DHIS2 immunization tutorial#650
jeremi merged 1 commit into
mainfrom
agent/fix-dhis2-tutorial-openapi

Conversation

@jeremi

@jeremi jeremi commented Aug 5, 2026

Copy link
Copy Markdown
Member

Summary

  • download the full DHIS2 OpenAPI document from /api/openapi.yaml, which declares the tracked-entity operation and response schema used by the tutorial
  • document the nonfatal schema warnings emitted by evidencectl source suggest
  • complete the Evidence Gateway terminology update, remove the draft gate marker, and mark the replayed tutorial current
  • add complete local cleanup commands

User impact

Readers can now complete the source-authoring and request-preparation journey instead of failing first on a missing OpenAPI operation and then on bounded-integer verification.

Dependency

Verification

  • authenticated to the public DHIS2 2.43.1 demo with its published shared credentials
  • downloaded the full public OpenAPI document and ran the tutorial's exact evidencectl source suggest selections successfully
  • replayed every authored YAML and Rhai fence in a clean project
  • started local Evidence and Mint services and completed evidencectl request prepare with sanitized local inputs
  • did not send a live subject request or retain a demo record identifier
  • npm run check:markdown -- src/content/docs/tutorials/issue-immunization-evidence-from-dhis2.mdx
  • node scripts/run-vale.mjs src/content/docs/tutorials/issue-immunization-evidence-from-dhis2.mdx
  • npx astro check (0 errors; one existing deprecation hint)

@jeremi jeremi changed the title docs: fix DHIS2 tutorial OpenAPI source docs: complete DHIS2 immunization tutorial Aug 5, 2026
Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>
@jeremi
jeremi force-pushed the agent/fix-dhis2-tutorial-openapi branch from 2d5bc32 to cadbaa0 Compare August 6, 2026 02:38
@jeremi
jeremi marked this pull request as ready for review August 6, 2026 02:38
@jeremi
jeremi enabled auto-merge (squash) August 6, 2026 02:38
@jeremi
jeremi merged commit 9d9bdc6 into main Aug 6, 2026
29 checks passed
@jeremi
jeremi deleted the agent/fix-dhis2-tutorial-openapi branch August 6, 2026 02:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant