Re: [docbook] Add topic element to DocBook?

["Michael(tm) Smith" <smith@sideshowbarker.net>]

Chris Chiasson <chris@chiasson.name>, 2006-10-27 00:28 -0500:

> I am afraid of this new <topic> element. However, I don't want DocBook
> to stagnate while DITA grows just because some people are afraid of
> change.

Substitute the word "wary" for "afraid". The thing about changes
is that they often have unforeseen consequences. For example, we
decided to add Task as a child of section, and a year or two
later, we've got to figure if/how to allow Task content in places
where by design it's currently not permitted.

And I don't think there's any risk of DocBook stagnating. It's
soundly designed and is meeting the needs of its target user base
quite well. It's going to remain just as useful a solution as it
always has been: A common vocabulary and processing infrastructure
(the DocBook XSL stylesheets) that even users/groups with very
limited resources can learn and use productively -- without the
need or time or money to do stuff like customizing/extending the
schema/DTD or to write their own sets of stylesheets.

And as far as DITA goes, I guess some might argue that it's tuned
for a different target user base: organizations that manage large
and complex sets of content and that can save a lot of money by
using a system that's specifically built, from the ground up, to
faciliate extensive content reuse and to faciliate creation of
custom markup specialized to their particular needs.

Anyway, in spite of the possibility that the information-mapping
topic-based authoring approach may not really be the right
solution for many organizations (especially those that aren't
smart enough or careful enough about avoiding all the possible
pitfalls around it), it is what a lot of them in the corporate
tech-writing world seem to want. And I suspect that many
organizations who want that were not using or considering DocBook
to begin with; I'd guess many had some legacy system based on
authoring in, at best, Framemaker -- and at worst, MS Word or
RoboHelp or whatever. A move by anybody away from that stuff and
into any XML and XSLT-based system is a win for all of us.

  --Mike

smime.p7s