After review, Jeff and I are generally okay with this,
but if we're planning to approve something at next week's
telcon, we need to be sure we know what we're approving.
In most cases, Eliot's email does do that, but not in all.
[Note, despite the subject--which suffers from legacy--this
proposal is just about cross-references to topicheads. It
does not mention/address implicit title-only topics.]
More detailed "editorial" comments below (nothing technical).
>
Original Message-----
> From: Eliot Kimber [mailto:ekimber@reallysi.com]
> Sent: Monday, 2009 May 04 18:02
> To: dita
> Subject: [dita] ITEM: Cross-references to Topicheads and
> Implicit Title-only Topics
>
> Here is Michael and my proposed resolution of this issue.
>
> The key technical decisions are:
>
> 1. An xref via @href to a topicref is always a pointer to the
> topicref, whether or not it has a @keys attribute.
>
> 2. Processors may treat the reference as a direct reference
> to the topicref
> (navigation artifact) or to the topic pointed to or implied
> (via chunking) by the topicref.
>
> Given this clarification of the implications for href=, the
> following items
> in the language reference should be updated as follows:
>
>
> 1. Under "Using keys and keyref"
>
> 1.A. Change:
> "During processing key references in topics and maps are
> resolved using key definitions from maps." to:
>
> "During processing key references in topics and maps are
> resolved using key
> definitions from maps when key-defining topicrefs are
> addressed by key.
>
> 1.B After the paragraph starting "During processing", add the note:
>
> Note: A key-defining topicref that also has an @id attribute
> and that is
> pointed to by that ID, rather than by its key, does not
> necessarily act as
> an indirection. In that case, processors may choose to treat as the
> effective target of the ID reference either the topicref itself or the
> ultimate target of the topicref.
We're okay with #1.
>
> 2. Under the reference for "xref":
>
> 2.A Delete the last sentence of the first para "The href
> attribute on the
>