Re: [docbook] Markup for revisions / comments

["Bob Stayton" <bobs@sagehill.net>]

This may not help you, since DocBook v5 is still under development, but it
has a new annotation element that would be appropriate for this purpose.
An annotation element can contain an info element to track author, and a
nice mix of other elements for expressing comments.  And its 'annotates'
attribute is meant to point to the element it is annotating, which is not
necessarily the element containing it.  So you could annotate another
annotation to string together a sequence of comments.

There is some experimental support in the html stylesheet for the
annotation element.  See the html/annotations.xsl stylesheet file.  But
your application would require a customization, probably using roles on the
annotations so they would be handled the way you expect them to be.

If you need to use DocBook4, then the remark element is your best bet.  It
accepts author and revhistory as part of its content mix.  You can even
nest remarks inside remarks.

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net


----- Original Message ----- 
From: "Jose Gonzalez Gomez" <jgonzalez.openinput@gmail.com>
To: <docbook@lists.oasis-open.org>
Sent: Wednesday, February 22, 2006 6:56 AM
Subject: [docbook] Markup for revisions / comments


Hi there,

Is there any kind of markup for specifying a comment during the revision of
a document, keeping track of the author? I'm thinking about a docbook
document that is sent for review, and reviewers write their comments, even
answering to each other. Is this possible to do with docbook? I know about
remark, but don't know if this may be used in combination with some other
tag.

Thanks in advance, best regards
Jose