Re: [docbook] Polymorphic Modular DocBook

[Scott Hudson <scott.hudson@flatironssolutions.com>]

Hi Camille,

IMO, DocBook works very well for modular documentation. That said, I 
usually recommend chunking at the section level, leaving the book, 
chapters, etc. as "assembly templates/documents". The book and chapters 
contain the higher level wrappers and additional verbage that is 
appropriate for that level, and then contain entity references or 
XIncludes to the section-level chunks that are to be reused.

Best regards,

--Scott

Camille Bégnis wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Hi all,
>
> I used big words in the subject, but it's a simple issue: When doing
> modular DocBook, it sometimes happen that a "chapter" module wants to be
> reused as an "appendix" for example...
>
> Is the only solution to use tinier modules by chunking at the "section"
> level, or is there something more intelligent?
>
> Or should we consider DocBook is not meant to be extremely modular,
> other grammars like DITA are more suited?
>
> Interested in hearing your experience.
>
> Camille.
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.2.2 (GNU/Linux)
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
>
> iD8DBQFEmonQjv9P65BfOUMRAuqFAJ9RlFh43Jn//l5LCaP9/yN1S8D2qQCfRxNG
> IV+TMnLp+nz+mQJ5OBN92fg=
> =iban
> -----END PGP SIGNATURE-----
>   
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-help@lists.oasis-open.org


-- 
begin:vcard
fn:Scott Hudson
n:Hudson;Scott
org:Flatirons Solutions;Content Management Services
adr:Suite 200;;4747 Table Mesa Drive;Boulder;CO;80305;USA
email;internet:scott.hudson@flatironssolutions.com
title:Consultant
tel;work:303-542-2146
tel;cell:303-332-1883
note:Knowledge is Power. Sharing is Empowerment.
x-mozilla-html:TRUE
url:http://shudson310.blogspot.com
version:2.1
end:vcard