dhis2-devs team mailing list archive

[Jason Pickering <jason.p.pickering@xxxxxxxxx>]

Hi Calle,

Well, this might be part of the problem. Not many of us do, or have time,
but it needs to be done.  If you do not want to write documentation or
HISP-SA cannot offer support in this regard, submit some bugs about the
documentation about what we need to improve ,and we will work on it.

https://github.com/dhis2/dhis2docs/issues

Right now, it is a blank slate, there, so plenty of room to offer some
constructive criticism about what needs to be improved.

Regards,
Jason


On Wed, Apr 8, 2015 at 4:00 PM, Calle Hedberg <calle.hedberg@xxxxxxxxx>
wrote:

> Jason,
>
> It's not that I don't WANT to write documentation - I've written a lot of
> DHIS documentation since designing DHIS 1.0 in 1997. But it's difficult to
> do that without in-depth knowledge of exactly how everything works, what is
> supported and what is not supported - at the moment I just hitting what
> feels like one wall after another (bugs, design issues) to just get DHIS2
> up and running properly for our 55-60 databases.
>
> Anyway, let's see how it will work - I've "committed" too
>
> Regards
> Calle
>
> On 8 April 2015 at 15:50, Jason Pickering <jason.p.pickering@xxxxxxxxx>
> wrote:
>
>> Hi Calle,
>>
>> I would agree with you and have acknowledged this as you say. However,
>> since a large part of the documentation has been developed purely as a
>> volunteer effort, it is what it is.  As I also epxlained in the workshop
>> last summer (and several times on this list) the documents are open source,
>> you are free (as are all) to contribute to improving them.The core team
>> will be improving the documents gradually, as there is now central support
>> ffor this, and issues on GtitHub are most welcome.  But like I said, if you
>> do not like what is there, feel free to get involved.
>>
>> Also, if you do not want to participate in the Stack Exchange, there is
>> no need to. We are trying this as a bit of experiment, and if it works,
>> great, if it does not, then we can consider other route. However,
>> StackExchange is a great resource for many technical communities, and it
>> does not necessarily need to be limited to "techie" discussion. It is quite
>> a difficult process to even get accepted into the site, but if we do, then
>> it could potentially be a great resource for the community .
>>
>> Best regards,
>> Jason
>>
>>
>> On Wed, Apr 8, 2015 at 3:41 PM, Calle Hedberg <calle.hedberg@xxxxxxxxx>
>> wrote:
>>
>>> Jason,
>>>
>>> Again maybe - I'm concerned about too many avenues/sites for technical
>>> info that tend to change frequently, with the core team being unable to
>>> maintain them and increasingly not responding at all or responding with the
>>> usual RTFM (as you pointed out in your documentation presentation in Oslo
>>> last year, the documentation is poor and fragmented - it's next to
>>> impossible to find solutions to significant problems using that route
>>> because so many things are NOT documented or it's buried under a lot of
>>> techie lingo with limited or non-existent links to real-world issues as
>>> they are viewed by people in the field).
>>>
>>> I'm increasingly convinced that we need fewer documents/sites for
>>> technical info - and rather one major source that digs really deep into
>>> every single aspect of the UI and processes, outlining both what is there
>>> and what isn't. Too much of that is currently only in the heads of the core
>>> team, which are overwhelmed and not able to respond to the more complicated
>>> issues.
>>>
>>> Regards
>>> Calle
>>>
>>>
>>>
>>> On 8 April 2015 at 14:01, Jason Pickering <jason.p.pickering@xxxxxxxxx>
>>> wrote:
>>>
>>>> Hi Calle,
>>>> The thinking here is that you will not need to ask the core team for a
>>>> lot of stuff, so they can focus on other stuff.  This lists gets a lot of
>>>> repeat questions and a lot of questions which could be answered if people
>>>> bothered to read the documentation. Stack Exchange offers a means to keep
>>>> answers in questions in a more FAQ type of format. It is not really meant
>>>> to be a replacement for this list, but a more searchable site than the
>>>> current mailing list (which admittedly is not always easy to dig through to
>>>> find a specific answer to a given problem)
>>>>
>>>> Regards,
>>>> Jason
>>>>
>>>>
>>>> On Wed, Apr 8, 2015 at 1:48 PM, Calle Hedberg <calle.hedberg@xxxxxxxxx>
>>>> wrote:
>>>>
>>>>> Hi
>>>>>
>>>>> OK, but getting answers (or even confirmation that the query has been
>>>>> received) via direct questions to the core team or via the dev list is
>>>>> generally difficult except for the simple/obvious stuff. Will adding
>>>>> another community forum change that?
>>>>>
>>>>> Regards
>>>>> Calle
>>>>>
>>>>> On 8 April 2015 at 13:27, Lars Helge Øverland <larshelge@xxxxxxxxx>
>>>>> wrote:
>>>>>
>>>>>> Hi all,
>>>>>>
>>>>>> thanks to your help we made it to the last stage of the stackexchange
>>>>>> evaluation. We now need you to "commit" to using the site - your help is
>>>>>> appreciated!
>>>>>>
>>>>>> http://area51.stackexchange.com/proposals/77757/dhis2
>>>>>>
>>>>>> It only takes a second - please go to the link above, create an
>>>>>> account if you didn't already, and click the "commit" link.
>>>>>>
>>>>>> We believe that having an online question-and-answers community will
>>>>>> be very helpful for giving people access to DHIS-related knowledge.
>>>>>>
>>>>>>
>>>>>> [image: Inline image 1]
>>>>>>
>>>>>> best regards,
>>>>>>
>>>>>> Lars
>>>>>>
>>>>>>
>>>>>> _______________________________________________
>>>>>> Mailing list: https://launchpad.net/~dhis2-devs
>>>>>> Post to     : dhis2-devs@xxxxxxxxxxxxxxxxxxx
>>>>>> Unsubscribe : https://launchpad.net/~dhis2-devs
>>>>>> More help   : https://help.launchpad.net/ListHelp
>>>>>>
>>>>>>
>>>>>
>>>>>
>>>>> --
>>>>>
>>>>> *******************************************
>>>>>
>>>>> Calle Hedberg
>>>>>
>>>>> 46D Alma Road, 7700 Rosebank, SOUTH AFRICA
>>>>>
>>>>> Tel/fax (home): +27-21-685-6472
>>>>>
>>>>> Cell: +27-82-853-5352
>>>>>
>>>>> Iridium SatPhone: +8816-315-19274
>>>>>
>>>>> Email: calle.hedberg@xxxxxxxxx
>>>>>
>>>>> Skype: calle_hedberg
>>>>>
>>>>> *******************************************
>>>>>
>>>>>
>>>>> _______________________________________________
>>>>> Mailing list: https://launchpad.net/~dhis2-devs
>>>>> Post to     : dhis2-devs@xxxxxxxxxxxxxxxxxxx
>>>>> Unsubscribe : https://launchpad.net/~dhis2-devs
>>>>> More help   : https://help.launchpad.net/ListHelp
>>>>>
>>>>>
>>>>
>>>>
>>>> --
>>>> Jason P. Pickering
>>>> email: jason.p.pickering@xxxxxxxxx
>>>> tel:+46764147049
>>>>
>>>
>>>
>>>
>>> --
>>>
>>> *******************************************
>>>
>>> Calle Hedberg
>>>
>>> 46D Alma Road, 7700 Rosebank, SOUTH AFRICA
>>>
>>> Tel/fax (home): +27-21-685-6472
>>>
>>> Cell: +27-82-853-5352
>>>
>>> Iridium SatPhone: +8816-315-19274
>>>
>>> Email: calle.hedberg@xxxxxxxxx
>>>
>>> Skype: calle_hedberg
>>>
>>> *******************************************
>>>
>>>
>>
>>
>> --
>> Jason P. Pickering
>> email: jason.p.pickering@xxxxxxxxx
>> tel:+46764147049
>>
>
>
>
> --
>
> *******************************************
>
> Calle Hedberg
>
> 46D Alma Road, 7700 Rosebank, SOUTH AFRICA
>
> Tel/fax (home): +27-21-685-6472
>
> Cell: +27-82-853-5352
>
> Iridium SatPhone: +8816-315-19274
>
> Email: calle.hedberg@xxxxxxxxx
>
> Skype: calle_hedberg
>
> *******************************************
>
>


-- 
Jason P. Pickering
email: jason.p.pickering@xxxxxxxxx
tel:+46764147049