← Back to team overview

dhis2-devs team mailing list archive

Re: DHIS 2 Documentation

 

So the only thing to be aware of using a format such as docbook, is that it tends to slow down the process of keeping the information uptodate. Checking the documentation into the version control system, and not being able to correct the documentation the same place as you are reading it, is a significant barrier. It will not exactly make it easier to invite new non-developers to contribute. A web based documentation solution (a wiki or something) would make that much easier.

On the other hand, if the alternative is office documents (as I guess it realistically is here), docbook is a better choice. So I´m not trying to kill the progress, just raising the issue :)

Jo


References