dhis2-devs team mailing list archive

[Bob Jolliffe <bobjolliffe@xxxxxxxxx>]

I think docbook is a really good choice for DHIS documentation.  And the
emacs mode works more than fine ...

Openoffice will also save as docbook.  I haven't checked how clean it is,
but it is possibly a good route for first pass conversion from ms word.

Cheers
Bob

2009/9/10 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
> >>
> >
>
> _______________________________________________
> 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
>