[Firebird-docs] Howtos: <article> or <book> ?

[Paul V. <pa...@vi...>]

Hello all,

With my second Howto nearing completion, I'm facing the decision of
how to place them in our manual set. Because Howtos are relatively
short it seems natural to define them as DocBook <article>s rather
than <book>s.

Unfortunately, an <article> can not be placed directly in a <set>.
(This is a shortcoming of DocBook in my opinion.)
So for the time being I've created - in my working copy - a <book>
called Firebird Howtos, which in turn contains the Howto <article>s.
But this feels awkward - after all, a Howto is an independent
document in its own right, just like a book. It just happens to be
less bulky...

I also think we should be able to render each Howto as a separate PDF,
just like the other books (still have to figure out how though: at
present all we get is one big PDF containing the entire book set).

So now I'm inclined to insert them as <book>s after all when the time
comes.

Any ideas?


Greetings,
Paul Vinkenoog