← Back to team overview

dhis2-devs team mailing list archive

Re: Documentation

 

Hi Juma,
You are more than welcome and I am sure your documents would be useful
to the rest of us. I would suggest you get started by reading through
the Documentation guide, and getting started with getting an account
on Launchpad if you do not already have one. You will also need to get
a few pieces software such as Serna Free if you want a WYSIWYG editor
for DocBook, or you can really use essentially any XML tool that you
are comfortable with. In order to build the documents locally on your
machine, you will need to install Java and Maven. All of this is
documented in the documentation guide.

I have some spare time on my hands right now, so I can help you get
started. The initial conversion from Microsoft Word to DocBook can be
the most painful process.

Best regards,
Jason



On Wed, Dec 9, 2009 at 10:20 AM, Juma Lungo <juma.lungo@xxxxxxxxxxxx> wrote:
> Thanks Jason
> i would like to be part of this movement.
> we have also created some pieces of documentations.
> for example how to install DHIS2 in Ubuntu, and some health programme
> specific training manuals.
> lets see how we can incoorperate this into the larger document.
>
> Lungo
>
> Jason Pickering wrote:
>
> Hi Lungo,
> I have been helping out with the documentation effort. I am not sure
> how much of the conversation you have followed, so I will briefly
> start from the top. We had a discussion a few months back about trying
> to consolidate all of the different documentation efforts into a
> single repository, so that we can all collaborate together on it. We
> decided to try and move all of the documentation to the DocBook
> format, which is a pure XML format that is presentation neutral and
> makes it easier for us to produce modular documents in a distributed
> manner.
>
> You can take a look at the documentation guide, to get you started. It
> is available here..
>
> http://dhis.uio.no/ci/job/Dhis2%20documentation/lastSuccessfulBuild/artifact/target/site/en/pdf/dhis2_documentation_guide.pdf
>
> It may look rather daunting at first, but once you get started, it is
> pretty easy, especially if you are using one of the WYSIWYG editors
> like Serna Free.
>
> I will be happy to try and help get you started.
>
> Best regards,
> Jason
>
>
>
>
> On Wed, Dec 9, 2009 at 9:48 AM, Juma Lungo <juma.lungo@xxxxxxxxxxxx> wrote:
>
>
> Hi Lars
>
> may be i have missed an email.
> where is the current documentation you are refering to.
> dhis2 documentation is a top priority work for the tanzanian case now.
>
> Lungo
>
>
> Jason Pickering wrote:
>
> Hi Lars,
> Agreed for now.
>
> I have some extra time on my hands right now, so I can try and work on
> this a bit more if you get some more material.
>
>
> regards,
> Jason
>
> 2009/12/8 Lars Helge Øverland <larshelge@xxxxxxxxx>:
>
>
> Thanks a lot for this contribution Jason. The docs is really starting to
> look better.
>
> I will talk to Calle and see if he has some inputs. HISP SA has apparently
> produced a lot of material which could be borrowed from.
>
> Re the inclusion in trunk I have changed my mind anyway, the size of the doc
> branch is increasing quickly with all the images and would add too much size
> for people only wanting the code.
>
> Lars
>
>
>
>
>
>
>
>
>
>



References