Appendix B.  DHIS Documentation Guide

Table of Contents

B.1. DHIS 2 Documentation System Overview
B.2. Introduction
B.3. Getting started with Launchpad
B.4. Getting the document source
B.5. Editing the documentation
B.6. Using images
B.7. Linking documents together
B.8. Handling multilingual documentation
B.9. Building the documentation
B.9.1. Building the documentation with Apache maven
B.9.2. Building with xmlto
B.10. Committing your changes back to Launchpad

B.1. DHIS 2 Documentation System Overview

DHIS 2 is a web-based aggregate information management system under very active development. While primarily intended for management of aggregate, georeferenced health data, it should be possible to use the system for other purposes as well. Currently, there are a large number of disconnected pockets of documentation in various formats (e.g. MediaWiki, Word documents, Confluence). There is a need to consolidate the documentation process and bring it more in-line with the distributed nature of the development of the application itself. It has been suggested therefore to move the current documentation to the DocBook platform. This article will not discuss the relative merits of the DocBook platform, but rather will serve as a brief guide to its use by DHIS 2 implementers, users and developers. Readers are encouraged to make their own decision about whether to use DocBook or not for documentation purposes.