The documentation format to use should be entirely a choice of the author of the documentation. However, I encourage serious consideration of the suggestion of Frédéric Demains to use AsciiDoc. AsciiDoc may be the easiest most accessible program to use for writing documentation for DocBook. AsciiDoc uses a wiki like plain text syntax which users of a wiki would find familiar for easy contribution. Frédéric had not mentioned the important point that a core feature of AsciiDoc is to output documents in DocBook format. Using AsciiDoc may provide no actual disadvantages relative to DocBook directly because DocBook is available as an output format. Using AsciiDoc may provide several accessibility advantages over using DocBook directly which may be stronger than the same accessibility reason given for using DocBook directly. Thomas Dukleth Agogme 109 E 9th Street, 3D New York, NY 10003 USA http://www.agogme.com +1 212-674-3783 On Mon, October 19, 2009 14:29, Nicole Engard wrote:
Because that was what was asked of me by those who work in other languages :) No clue why I'm using it - I just do whatever I have to to make things accessible to all.
Nicole
On Mon, Oct 19, 2009 at 9:35 AM, Frederic Demians <frederic@tamil.fr> wrote:
Why are you using directly DocBook format which is a nightmare to deal with, editing, transforming? when you could use as lightweight markup language like asciidoc?
http://www.methods.co.nz/asciidoc/
asciidoc files can be translated to HTML and DocBook (and then PDF). asciidoc source files can very easily be tracked with git. Indeed git documentation is edited with asciidoc.
Thanks for the good work by the way :-) -- Frédéric DEMIANS http://www.tamil.fr/u/fdemians.html
_______________________________________________ Koha mailing list Koha@lists.katipo.co.nz http://lists.katipo.co.nz/mailman/listinfo/koha