RE: [dita-adoption] Groups - DITA 1.2 Feature Overview: Referencing a Range of Elements (feature-description-referencing-a-range-of-elements.doc) uploaded

["Grosso, Paul" <pgrosso@ptc.com>]

> -----Original Message-----
> From: joeg@suite-sol.com [mailto:joeg@suite-sol.com]
> Sent: Monday, 2009 August 17 4:11
> To: dita-adoption@lists.oasis-open.org
> Subject: [dita-adoption] Groups - DITA 1.2 Feature Overview: Referencing a
> Range of Elements (feature-description-referencing-a-range-of-elements.doc)
> uploaded
> 
> Thanks to everyone who sent comments. The new version has been uploaded.
> 
>  -- Mr. Joe Gelb
> 
> The document revision named DITA 1.2 Feature Overview: Referencing a Range
> of Elements (feature-description-referencing-a-range-of-elements.doc) has
> been submitted by Mr. Joe Gelb to the OASIS DITA Adoption TC document
> repository.  This document is revision #1 of
> feature-description-referencing-a-range-of-elements.doc.
> 
> Document Description:
> This feature overview describes how a component reference (conref) can be
> made to a range of adjacent (sibling) elements.
> 
> View Document Details:
> http://www.oasis-open.org/committees/document.php?document_id=33815
> 
> Download Document:
> http://www.oasis-open.org/committees/download.php/33815/feature-description-
> referencing-a-range-of-elements.doc
> 
> Revision:
> This document is revision #1 of
> feature-description-referencing-a-range-of-elements.doc.  The document
> details page referenced above will show the complete revision history.

Under Restrictions, the mentions to generalizing still make it
sound like the elements must (already) "be generalized to the 
same type" whereas they should instead "be generalizable to the 
same type".  If you don't like the word "generalizable", then
you could reword to say "should be the same element type (or a
specialization of that element type)...".

---

The first sentence of Example 3 is not complete.  It says that a
"range can include a variety of content, as long as the starting 
and ending elements share the same parent" which is not the full
story.  Instead, the sentence should say that a "range can include 
a variety of content, as long as the starting and ending elements 
share the same parent and are themselves both the same element type 
as (or a specialization of) that of the referencing element."

paul