At 2009-05-13 11:57 +0200, Michael Schdfer wrote:

  So I think that allowing the full set of DITA and DocBook
features for
  use in comments may introduce unnecessary complexity.

Interestingly I saw the choice of DITA and DocBook as introducing
simplicity because in both cases I use off-the-shelf stylesheets
(included in the package) that render these vocabularies to HTML.
No need to write one's own documentation vocabulary and then
stylesheets for that vocabulary.

And I have a number of customers' stylesheets documented with lists,
graphics, tables, program listings and other constructs that are all
sitting there ready to use in the off-the-shelf vocabularies.

best,
-Rob