Using userbase for manuals

Eike Hein hein at kde.org
Sun Jul 1 21:46:11 BST 2012


On 07/01/2012 09:56 PM, Chusslove Illich wrote:
> I further argue that, if people who are accustomed to version control find
> web-something-thingy (such as wiki) optimal for their documentation writing
> workflow, something has gone horribly wrong; and that efficiency of writing
> and maintenance, as well as documentation availability, will suffer because
> of it. Instead, they should keep documentation tight to their sources, and
> in format which best fits their writing concept. For example, there
> certainly exist wiki-like "offline" markups that can be converted to HTML
> pages (e.g. Markdown). I think we should encourage people to experiment in
> this direction, rather than press "learn Docbook".

I use asciidoc in another project which can be converted to
Docbook and is really nice:

http://www.methods.co.nz/asciidoc/



-- 
Best regards,
Eike Hein






More information about the kde-core-devel mailing list