OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook] alternative topic proposal

Bob Stayton wrote:

> A topic and an article are semantically similar, in that they are both 
> intended as standalone content.  But I would say that, semantically 
> speaking, an article is even more standalone, while a topic is generally 
> embedded in a collection of other topics of related subject matter to 
> which it makes references.  Maybe that sounds like a journal containing 
> a set of articles, but DocBook doesn't do journals.  8^)

It sounds to me like a topic is an article, and the proper mapping from 
DITA topics then is DocBook articles. I don't see any reason why 
appendix, colophon, and ackno would be less appropriate for a topic than 
an article (I have never seen a colophon in an article) and if you don;t 
want them you can just leave them out. DocBook is large enough as is. 
Let's not make it needlessly larger.

´╗┐Elliotte Rusty Harold  elharo@metalab.unc.edu
Java I/O 2nd Edition Just Published!

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]