Re: [dita] Rethinking the DITA Reference Docs

[Eliot Kimber <ekimber@reallysi.com>]

Eliot Kimber wrote:

> I can think of two possible solutions:

Um, I thought of three, obviously

> 1. Use metadata attributes on each xref to bind references to modules.

Just realized this wouldn't be quite so simple as there is connecting 
wording and punctuation associated with each item. Doh!

My instinct is that the reltable approach is the most elegant and 
sustainable, in part because it could be used for documentation of any 
DITA specialization without the need to explicitly write or generate 
contains and contained-by sections in the current style. But it would 
require a bit more work to implement the rendering. But that processing 
would also serve as a useful example of how to extend reltable 
processing, which is something I think the community needs.

Cheers,

Eliot

-- 
Eliot Kimber
Senior Solutions Architect
"Bringing Strategy, Content, and Technology Together"
Main: 610.631.6770
www.reallysi.com
www.rsuitecms.com