[Koha] Koha Manual in Git

[Thomas Dukleth]

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 at 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 at lists.katipo.co.nz
> http://lists.katipo.co.nz/mailman/listinfo/koha
>