Hi Alexey, On Tuesday 10 October 2006 10:22, Alexey Eremenko wrote:
[...] I am a bit afraid of the new format, DocBook. Why use it ? I feel more comfortable with HTML for documentation.
If you know how to write HTML then you shouldn't have any difficulties using DocBook. If you write in a single source environment HTML is not a good option. DocBook is one of the formats that is used frequently by documentation people (although DITA seems to get some speed, but that's another story.) DocBook is a stable DTD with very good XSLT stylesheets that can create HTML, Manpages, PDF and other useful things. Do you know the Linux Documentation Project[1]? A lot of documentation there is written in DocBook. KDE and GNOME use it too. And Subversion, and ... you got it. :) Tom ------- [1] http://www.tldp.org/ -- Thomas Schraitle ---------------------------------------------------------------------- SUSE LINUX GmbH >o) Documentation Specialist Maxfeldstrasse 5 /\\ 90409 Nuernberg _\_v http://en.opensuse.org/Documentation_Team --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-doc+unsubscribe@opensuse.org For additional commands, e-mail: opensuse-doc+help@opensuse.org