Documentation

Support - Assistance technique
21

We do of course have quite a bit more material from India also that will take time and effort to convert, and it would be great if the teams in Tanzania, Malawi and elsewhere could help out.

Additionally, much more material has been produced in India since the manual we now have was created - with it being printed in thousands of copies, and there are plans to commission more. It would be good if we could get a list of what is and will be available, as well as the source files for all material that is created.

I would also like to reiterate the great value in creating some promotional and some instructional videos like what OpenXData are doing:
http://www.youtube.com/watch?v=ThOTDorm980

http://www.youtube.com/watch?v=1N8236ReWnM
http://www.youtube.com/watch?v=eCHL0AU8A1A

For DHIS2, we so far have only one,created by Philippe Veltsos, and now out of date:
http://folk.uio.no/knutst/hisp/demo/

Knut

···

2009/12/8 Jason Pickering jason.p.pickering@gmail.com

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@gmail.com:

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

Mailing list: https://launchpad.net/~dhis2-devs

Post to : dhis2-devs@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-devs

More help : https://help.launchpad.net/ListHelp

–
Cheers,
Knut Staring

22

Hi,

I also like the way the manual is shaping up.

Well, at least we have something that sort of looks like a manual now. :slight_smile:

There is at least one major part missing though and that is what often is
called database maintenance or design.
with three major subsections:

1)Orgunits, hierarchies, group sets and groups:
What are they, how to set them up, what is the recommended usage.

Well, we can start with a simple outline and try and fill in the gaps.

2)Data elements, categories, datasets, groups and group sets:
What are data element, dimensions, and data sets? How to go from a paper
form to a DHIS dataset?
best practices, examples

Yes, the manual up until now has been pretty much which button do you
press. There needs to be a complete separate set of documents on
implementations.

How much from the Indian module can we use here?

I sent an email about the Indian modules a while back. I am not really
sure if we can salvage a whole lot else from them, except what I
mentioned in my mail. I have been sick in bed the past few days, and
have had no appetite for either food or DocBook, but I will take a
look this week.

And there are text on this on the help page as well that can be used:
DHIS2 App Hub

Agreed, but we need to figure out how and if the docbook branch and
the inline help should somehow be syncronized.

I think there are some useful text in the administrators manual I wrote some
years ago as well (http://folk.uio.no/olati/filer/Customising_DHIS2.pdf\).

Looks good. Do you have the Word Doc?

I can help to fill in the gaps here.

And then maybe another crucial chapter missing is "data analysis and
reporting", at least an intro to that with three core building blocks:

1) Aggregation
how it takes place (over time, over space, avg/sum, aggregation levels,
datamart
This is already in docbook format and needs to go into the main document

This is simple and I can commit this soon.

Should be try to come up with a more comprehensive table of contents in the
main doc (including stuff that is not written up) to get a better overview
of the gaps?

As mentioned above, I think an outline would be a very good starting
point, and given your experience with the development of DHIS,
implementations in the field, and work with HMN, I cannot think of a
better candidate for this. :wink:

Cheers,
Jason

···

On Tue, Dec 8, 2009 at 5:26 PM, Ola Hodne Titlestad <olatitle@gmail.com> wrote:

23

Hi Knut,

We do of course have quite a bit more material from India also that will
take time and effort to convert, and it would be great if the teams in
Tanzania, Malawi and elsewhere could help out.

I would be happy to try and jump start the process, especially since I
am next door in Lusaka.

Additionally, much more material has been produced in India since the manual
we now have was created - with it being printed in thousands of copies, and
there are plans to commission more. It would be good if we could get a list
of what is and will be available, as well as the source files for all
material that is created.

Where is it? Can you get the source data documents?

For DHIS2, we so far have only one,created by Philippe Veltsos, and now out
of date:
http://folk.uio.no/knutst/hisp/demo/

I think Phillipe would be a great person to make another one of these. :slight_smile:

Regards,
Jason

···

On Tue, Dec 8, 2009 at 6:49 PM, Knut Staring <knutst@gmail.com> wrote:

24

On a related note, it is also worth taking a look at what the
Geonetwork (a spatial metadata catalogue) has done with DocBook with
their documentation.

Regards,
jason

···

On Tue, Dec 8, 2009 at 7:37 PM, Jason Pickering <jason.p.pickering@gmail.com> wrote:

Hi Knut,

On Tue, Dec 8, 2009 at 6:49 PM, Knut Staring <knutst@gmail.com> wrote:

We do of course have quite a bit more material from India also that will
take time and effort to convert, and it would be great if the teams in
Tanzania, Malawi and elsewhere could help out.

I would be happy to try and jump start the process, especially since I
am next door in Lusaka.

Additionally, much more material has been produced in India since the manual
we now have was created - with it being printed in thousands of copies, and
there are plans to commission more. It would be good if we could get a list
of what is and will be available, as well as the source files for all
material that is created.

Where is it? Can you get the source data documents?

For DHIS2, we so far have only one,created by Philippe Veltsos, and now out
of date:
http://folk.uio.no/knutst/hisp/demo/

I think Phillipe would be a great person to make another one of these. :slight_smile:

Regards,
Jason

25

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:

···

larshelge@gmail.com

26

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..

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@zalongwa.com> 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@gmail.com>:

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

27

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:

···

http://dhis.uio.no/ci/job/Dhis2%20documentation/lastSuccessfulBuild/artifact/target/site/en/pdf/dhis2_documentation_guide.pdfjuma.lungo@zalongwa.comlarshelge@gmail.com

28

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@zalongwa.com> 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..

DHIS2 App Hub

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@zalongwa.com> 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@gmail.com>:

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

29

Hi Juma

Good to see you have some documentation for installing on Ubuntu. I did create a dhis2 “deb packager” last week which is in the repository under tools. Should make the ubuntu installation process much simpler. I can merge documentation for this with your documentation once you have it up.

Bob.

···

2009/12/9 Juma Lungo juma.lungo@zalongwa.com

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](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@zalongwa.com> 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@gmail.com>

: 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

Mailing list: https://launchpad.net/~dhis2-devs

Post to : dhis2-devs@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-devs

More help : https://help.launchpad.net/ListHelp