dhis2-devs team mailing list archive

[Ola Hodne Titlestad <olatitle@xxxxxxxxx>]

Hi,

To follow up on this discussion on documentation I would like to inform you
that there is an ongoing effort to write a wiki-based manual for DHIS 2
here:
http://www.openhealthconsortium.org/wiki/doku.php?id=dhis_2_documentation

I am not sure this is the right place or platform for writing up the manual,
but right now it seems like the most sensible place to start and contribute.
Later we can always export this into other forms of documentation, or move
it to a more appropriate place.

The main point is to start writing up what we know in one place.

Contact me for registration to the wiki which you need in order to edit any
pages there.

Ola
-----------


2009/9/3 Jason Pickering <jason.p.pickering@xxxxxxxxx>

> All implementers should contribute to documentation (finding time to do it
> is another issue),  but after a rather lengthy discussion with Ola today, I
> am not sure if I really even understand where to start. We had a rather
> lengthy chat about aggregation methods. I had seen that DHIS2 produced some
> funky indicator values, and now I understand why. The "aggegate start level"
> function was far from obvious, and incredibly important to understand for
> DHIS2 implementers. Perhaps some of the non-developers, such as myself,
> could help to contribute, but we at least need to have a fundamental
> understanding of how the system really functions, at its most basic level,
> without having to delve into the source code.
>
>  Some functions, such as addition of data elements seem straightforward.
> Others, such as the aggregation method I mention here are far from
> straightforward. I would tend to think the dev should start with a framework
> of the functionality, and perhaps the implementers could flesh out the
> "which-button-to-press" functionality.
>
>
>
> 2009/9/3 Lars Helge Øverland <larshelge@xxxxxxxxx>
>
>>
>>
>>
>> Yes we do. Obviously the developers are stretched, they should give a
>> technical description of how things works but someone needs to sit down and
>> write this down nicely. Johan has been talking about writing documentation
>> for a long time. Is there any progress here? Is there anyone else who feels
>> like contributing?
>>
>> Also, we have implemented an integrated help system in dhis2, where we put
>> an icon beside the relevant function which displays a popup when clicked. A
>> non-developer could write the doc/help text and a note of where it should
>> be.
>>
>> Lars
>>
>>
>> On Thu, Sep 3, 2009 at 8:53 PM, Ola Hodne Titlestad <olatitle@xxxxxxxxx>wrote:
>>
>>> We desperately need user doc for new functionality like this.
>>> If even the developers can't understand it how will the users?
>>> Another case I came across earlier today that needs some documentation is
>>> the new feature of aggregation levels for data elements.
>>> And there are many more examples....
>>>
>>>
>>> Ola Hodne Titlestad |Technical Officer|
>>> Health Metrics Network (HMN) | World Health Organization
>>> Avenue Appia 20 |1211 Geneva 27, Switzerland | Email: titlestado@xxxxxxx
>>> |Tel:
>>> +41 788216897
>>> Website: www.healthmetricsnetwork.org
>>>
>>> Better Information. Better Decisions. Better Health.
>>>
>>>
>>> 2009/9/3 Lars Helge Øverland <larshelge@xxxxxxxxx>
>>>
>>> > Public bug reported:
>>> >
>>> > The custom value list functionality does not work properly
>>> (dataset-edit
>>> > custom value):
>>> >
>>> > - After selecting a dataset, then the default category combo, an un-
>>> > i18n-ified message saying "no_more_categories_to_select". Not sure what
>>> > this means.
>>> >
>>> > - After typing in a value and clicking "add new custom value", two
>>> > occurrences of that value show up in the selected list.
>>> >
>>> > - The heading of the selected list should be "selected custom values",
>>> > not "select custom value".
>>> >
>>> > - Feedback is given through javascrip popups, while the system standard
>>> > is to use span fields ( <span id="message"></span> ).
>>> >
>>> > - The message "dude, duplicates are not allowed" is displayed if you
>>> try
>>> > to enter duplicates.
>>> >
>>> > - The list of suggested values has duplicates. It should not.
>>> >
>>> > - I am not able to see any custom values in data entry, nor for
>>> regular,
>>> > category and custom forms. I might be me that has not understood how it
>>> > works.
>>> >
>>> > ** Affects: dhis2
>>> >     Importance: Undecided
>>> >         Status: New
>>> >
>>> > --
>>> > custom-value-list-does-not-work
>>> > https://bugs.launchpad.net/bugs/423891
>>> > You received this bug notification because you are a member of DHIS 2
>>> > coordinators, which is the registrant for DHIS.
>>> >
>>> > Status in DHIS 2: New
>>> >
>>> > Bug description:
>>> > The custom value list functionality does not work properly
>>> (dataset-edit
>>> > custom value):
>>> >
>>> > - After selecting a dataset, then the default category combo, an
>>> > un-i18n-ified message saying "no_more_categories_to_select". Not sure
>>> what
>>> > this means.
>>> >
>>> > - After typing in a value and clicking "add new custom value", two
>>> > occurrences of that value show up in the selected list.
>>> >
>>> > - The heading of the selected list should be "selected custom values",
>>> not
>>> > "select custom value".
>>> >
>>> > - Feedback is given through javascrip popups, while the system standard
>>> is
>>> > to use span fields ( <span id="message"></span> ).
>>> >
>>> > - The message "dude, duplicates are not allowed" is displayed if you
>>> try to
>>> > enter duplicates.
>>> >
>>> > - The list of suggested values has duplicates. It should not.
>>> >
>>> > - I am not able to see any custom values in data entry, nor for
>>> regular,
>>> > category and custom forms. I might be me that has not understood how it
>>> > works.
>>> >
>>>
>>> --
>>> custom-value-list-does-not-work
>>> https://bugs.launchpad.net/bugs/423891
>>> You received this bug notification because you are a direct subscriber
>>> of the bug.
>>>
>>> Status in DHIS 2: New
>>>
>>> Bug description:
>>> The custom value list functionality does not work properly (dataset-edit
>>> custom value):
>>>
>>> - After selecting a dataset, then the default category combo, an
>>> un-i18n-ified message saying "no_more_categories_to_select". Not sure what
>>> this means.
>>>
>>> - After typing in a value and clicking "add new custom value", two
>>> occurrences of that value show up in the selected list.
>>>
>>> - The heading of the selected list should be "selected custom values",
>>> not "select custom value".
>>>
>>> - Feedback is given through javascrip popups, while the system standard
>>> is to use span fields ( <span id="message"></span> ).
>>>
>>> - The message "dude, duplicates are not allowed" is displayed if you try
>>> to enter duplicates.
>>>
>>> - The list of suggested values has duplicates. It should not.
>>>
>>> - I am not able to see any custom values in data entry, nor for regular,
>>> category and custom forms. I might be me that has not understood how it
>>> works.
>>>
>>
>>
>> _______________________________________________
>> Mailing list: https://launchpad.net/~dhis2-devs<https://launchpad.net/%7Edhis2-devs>
>> Post to     : dhis2-devs@xxxxxxxxxxxxxxxxxxx
>> Unsubscribe : https://launchpad.net/~dhis2-devs<https://launchpad.net/%7Edhis2-devs>
>> More help   : https://help.launchpad.net/ListHelp
>>
>>
>
> _______________________________________________
> Mailing list: https://launchpad.net/~dhis2-devs<https://launchpad.net/%7Edhis2-devs>
> Post to     : dhis2-devs@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~dhis2-devs<https://launchpad.net/%7Edhis2-devs>
> More help   : https://help.launchpad.net/ListHelp
>
>