[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-i18n-doc
Subject:    Re: Pology user manual
From:       Burkhard =?iso-8859-15?q?L=FCck?= <lueck () hube-lueck ! de>
Date:       2010-09-27 20:11:58
Message-ID: 201009272211.58688.lueck () hube-lueck ! de
[Download RAW message or body]

Am Mittwoch, 22. September 2010, um 16:31:15 schrieb Chusslove Illich:
> There is now a user manual within Pology itself:
> 
>   trunk/l10n-support/pology/
>       doc/user/html/index.html (one HTML page by chapter)
>       doc/user/html/index-mono.html (everything on one page)
> 
Great, thanks :)

> The manual is not yet complete (chapters 5, 6, 10, 11 are blank), but I
> think it is sufficiently useful to start periodically generating HTML pages
> _from Docbook source.
> 
> Actually, Pology was never that badly documented, it's just that the
> documentation was scattered around a bitı. Most of the current content of
> the manual (as well as some that I have yet to add) I have just collected
> and edited a bit to fit together. Any new details are mostly in chapters 8
> and 9 (e.g. on validation rules with the check-rules sieve).
> 
> [1] I don't like Docbook very much, and therefore a few years ago I had
> this idea of documenting stuff with API doc and wiki (on the Techbase). My
> liking of Docbook has not increased since, but the alternative I chose
> turned out worse, especially for me as the writer. So I came running back
> to Docbook. Mentioning this because some people, apparently, have an
> opposite opinion these days :)

;-)

-- 
Burkhard Lück

[prev in list] [next in list] [prev in thread] [next in thread]