#299 Allow Article inside Set



according to the TDG[1], <set> allows another <set> or <book>, but no <article>. I would like to propose to include article as a possible child of <set> in the DocBook schema.

Documentation for software products often contains not only Reference Manuals, but also Whitepapers and Quick Starts. The latter two are
typically <article>s.

In order to bundle the complete product documentation into a <set> to allow cross-linking, it currently is necessary to bundle the <article>s
into a <book>. This is unfortunate, when
a) only having one article that needs to be added,
b) a number of articles covering not-related topics
c) generating HTML/ePUB for the whole set (see TOC)

For this reason, I think, an <article> would perfectly fit as a possible child of <set>. It avoids the need to create additional book structures
just for the sake of being able to add articles to a set.


--- References:
[1] http://www.docbook.org/tdg/en/html/set.html


  • Norman Walsh

    Norman Walsh - 2012-11-14

    Fixed in 5.1

  • Norman Walsh

    Norman Walsh - 2012-11-14
    • status: open --> open-accepted
  • Norman Walsh

    Norman Walsh - 2012-11-14
    • status: open-accepted --> open-fixed
  • Robert Stayton

    Robert Stayton - 2013-02-19
    • status: open-fixed --> closed-fixed

Log in to post a comment.