dhis2-devs team mailing list archive

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

Hi Lars,

I prefer XMLSpy, but this a personal preference, and I am used to
using it. It is a commercial product, but very good.

As for free products, Vex is pretty good and simple, but not sure it
is actively maintained. XMLMind was pretty good as well, but not quite
as easy to use as Vex.

If you prefer text based editors, JEdit is a good choice. Notepad++
for Windows users may be an option as well.

Of course there is always good ole Emacs.

There is a long list available here.

http://wiki.docbook.org/topic/DocBookAuthoringTools

I have committed a portion of the GIS user manual, along with a HTML
file with one of the many XSLs availble for DocBook format in the docs
section for review. If there is enough interest, I will go ahead and
convert the rest of the document.

Best regards,
jason




Regards,
Jason


On 9/10/09, Lars Helge Øverland <larshelge@xxxxxxxxx> wrote:
> Hi Jason, this looks interesting, can you recommend a docbook editor?
>
> Lars
>
>
> On Wed, Sep 9, 2009 at 8:31 PM, Jason Pickering
> <jason.p.pickering@xxxxxxxxx
>> wrote:
>
>> Hi Everyone,
>>
>> I have been speaking with Jan and Old a bit about documentation and
>> before
>> I start committing anything, or making too many changes, I would like to
>> get
>> some feedback from everyone.
>>
>> Let me be quite honest. I find the documentation of DHIS2 to be quite
>> appalling. It is scattered between different Wiki sites, Launchpad,
>> mailing
>> lists, and various documents here and there. We need to do better.
>>
>> Jan has started a document on the GIS portion of DHIS2 and I would like
>> to
>> suggest that we standardize all documentation by using the DocBook
>> format.Visit  www.*docbook*.org for more info. I will not repeat the
>> various advantages of using this format over others, other than to say it
>> is
>> very common, it is structured, and is supported by a large number of
>> editors
>> and can be transformed into essentially any format . Since DocBook is
>> pure
>> XML it is much more suited to the sort of distributed development
>> environment we are working in, as opposed to say proprietary, binary word
>> documents or other formats.
>>
>> Any reactions here? I have started a bit of work on the conversion of the
>> GIS manual to DocBook format, but wanted to get feedback from the
>> community
>> before I proceeded much further. Of course, documentation in a structure
>> format like XML will be a bit more painful, but there are several tools
>> out
>> there (many of them OpenSource) that provide good editors for the format.
>> Of
>> course the ability to transform this XML info many different formats,
>> such
>> as HTML, Word, PDF, JavaHelp files (the list is very long) is a big
>> advantage in my mind.
>>
>> What does everyone think?
>>
>> Best regards,
>> Jason
>>
>