Re: [docbook] [Fwd: Re: [Fwd: Feedback on DocBook Transclusion proposal]]

[Jirka Kosek <jirka@kosek.cz>]

Kate.Wringe@sybase.com wrote:

> One feature that I think would be critical to any transclusion proposal is 
> the ability to know (via some automated way) what content is being 
> transcluded. 
> It is easy enough in the XML to find out where you are transcluding 
> content --you just need to find the transclusion tag.  However,
> when you are editing the content that is being transcluded elsewhere, 
> there is no way (other than manually marking the text with an attribute) 
> to know
> if what you are editing is being reused.

Hi Kate, I understand to this requirement but I think this is something
what content management system could do. But we shouldn't introduce any
special markup for this because it will be nightmare to manage
transclusion links in both directions to be always synchronized.

> Some transclusion solutions get around this issue by claiming that all 
> content should be written so that it can be reused; however, this is
> a rather large ideal to impose on one's documentation. 

And also this large ideal leads to text which is very ugly to read in
linear order IMHO.

				Jirka

-- 
------------------------------------------------------------------
  Jirka Kosek      e-mail: jirka@kosek.cz      http://xmlguru.cz
------------------------------------------------------------------
       Professional XML consulting and training services
  DocBook customization, custom XSLT/XSL-FO document processing
------------------------------------------------------------------
 OASIS DocBook TC member, W3C Invited Expert, ISO JTC1/SC34 member
------------------------------------------------------------------

OpenPGP digital signature