This community innovation has been accepted at the 2026 DHIS2 Annual Conference and will be in abstract track/lightning talk.
Documenting DHIS2 Design for System Sustainability
Background: Many national DHIS2 implementations face sustainability challenges after initial deployment due to inadequate documentation and loss of institutional system knowledge. When system design decisions, metadata structures, and workflows are not formally recorded, maintenance becomes difficult, system evolution is poorly controlled, and dependency on individual implementers increases. During the optimisation of Sri Lanka’s DHIS2 Tracker based under five child mortality surveillance system, the need for structured documentation emerged as a critical requirement for long term sustainability. Approach: This work focused on documenting and consolidating system design knowledge generated during the redesign and integration of a national DHIS2 Tracker programme. Documentation was treated as a core implementation output rather than a post implementation activity. Design rationales, workflow decisions, metadata configurations, and governance arrangements were systematically captured to support future maintenance and controlled system evolution. Implementation: A structured documentation package was developed, including a metadata dictionary, tracker configuration guide, workflow diagrams, and task-based user guides. Key technical components such as program stages, data elements, validation rules, and role-based access controls were explicitly documented alongside their intended purpose. Single task user guides were created to support routine operations and reduce reliance on informal knowledge transfer. Documentation was reviewed with national technical teams to ensure accuracy and usability. Lessons learned: The documentation process strengthened institutional ownership, reduced dependency on individual developers, and improved maintainability of the DHIS2 Tracker programme. It enabled faster onboarding of new technical staff and supported consistent system updates. The experience highlights the importance of embedding documentation within the system development lifecycle. Conclusion: This case study demonstrates that systematic documentation is essential for sustaining complex DHIS2 implementations and preserving national digital health system
Primary Author: Sachitra Prabath Wijethunga
Keywords:
DHIS2, system documentation, digital health sustainability, metadata documentation, metadata governance, tracker configuration, program stages, data elements, validation rules, role-based access control, health information systems, DHIS2 tracker, system maintenance, institutional knowledge, capacity building, knowledge management, digital public good, health system governance, national digital health systems, public health surveillance, child mortality surveillance, under-five mortality, maternal and child health, interoperability, digital public infrastructure, platform reuse, low- and middle-income countries, Sri Lanka