#299 Allow Article inside Set

v5.1
closed-fixed
Norman Walsh
5
2013-02-19
2012-09-24
Thomas Schraitle
No

Hi,

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.

Thanks!

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

Discussion

  • 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