[kde-doc-english] Is asciidoc for us?

Jaroslaw Staniek staniek at kde.org
Tue Jul 28 19:33:20 UTC 2015


Hi!
My use of docbook failed due to complexity. Also userbase-based docs
(at least for Kexi, for which a finished book could be easily over 300
pages) are far from perfect and not too actively maintained. No
surprise as it's too much of work if it's used "just" by KDE.

Still I am grateful for tools that we have now!

In the meantime I just installed asciidoc.[1] Some projects like git
use it for all documentation needs. There's support for localization
via po4a.
There's even more than one implementation.

Anyone considered asciidoc as a docbook replacement? It would be good
to discuss this and see how it fits for our needs.

[1] http://www.methods.co.nz/asciidoc/

-- 
regards, Jaroslaw Staniek

KDE:
: A world-wide network of software engineers, artists, writers, translators
: and facilitators committed to Free Software development - http://kde.org
Calligra Suite:
: A graphic art and office suite - http://calligra.org
Kexi:
: A visual database apps builder - http://calligra.org/kexi
Qt Certified Specialist:
: http://www.linkedin.com/in/jstaniek


More information about the kde-doc-english mailing list