Re: The KDE DocBook Markup Reference Handbook

["David C. Mason" <dcm redhat com>]

Pat Costello <Patrick Costello ireland sun com> writes:


> The KDE markup reference tome is indeed very handy. I especially
> liked the "Tags we do not use" section. My personal opinion is that
> we should have a Gnomic equivalent referece book. Also, I believe
> that Gnome style and Gnome markup should be clearly set apart in
> different locations. We should not mix the two reference
> sources. Style and markup are separate subjects.


I have never been a fan of 'we use this dtd' and 'we do not use these
elements from said dtd' - to me it shows that there is a laziness to
support the tags within the stylesheets. I think that DocBook gives
the writer a great deal of options (and not enough really) to
correctly mark up a content driven paper. We want to support *all* of
our documents in our help browser, and that includes things like API
documents which contain very different markup than user documents.

In my opinion, the only things that should be in a 'tags we don't use'
are tags that are scheduled to be obliterated from the DTD which we
have decided to exclude already.

Otherwise I agree with your post.

Cheers,

Dave