OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita-learningspec message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [dita-learningspec] Groups - Doctypes, sample data, and reference topics for DITA 1.3 stage 3 proposal 13089 uploaded


Let's try this review again, this time on the correct files.

1. The constraint content model for %topicref only needs to include keyref,
mapref, and topicgroup. The other elements are already allowed through other
paths. In particular, topicgroup explicitly allows navref, data, and
data-about in addition to topicref.

2. The constraint module filename should not have a leading capital. Per the
coding requirements, it should be "learningAggregations...", not
"LearningAggregations...".

3. Were the examples purposely omitted from the reference entries? I think
we need to provide examples of each of the new types.

4. The class hierarchy for learningGroupMapRef and learningObjectMapRef
cannot contain mapgroup-d/mapref.

5. For both learningGroupMapRef and learningObjectMapRef, need to have the
.attribute parameter entities in addition to the .content parameter
entities.

6. In the reference entries for the mapref elements, the semantics of a map
reference are not variable--the meaning of a map reference is always the
same, so there should be no need to repeat the text from mapref.

7. The descriptions of the learningObjectMap and learningGroupMap elements
don't emphasize the fact that such maps are intended to represent exactly
one learning object or learning group. That's an important aspect of the
design and needs to be highlighted. It might also be worth saying something
about any topicrefs that occur before the learningObject or learningGroup
elements are intended to be resource-only topicrefs such as key definitions.

My updates are attached, including RelaxNG declarations. Main change over
what I sent earlier is rename of the constraint module file from "Learning"
to "learning".

Cheers,

E.
-- 
Eliot Kimber
Senior Solutions Architect, RSI Content Solutions
"Bringing Strategy, Content, and Technology Together"
Main: 512.554.9368
www.rsicms.com
www.rsuitecms.com
Book: DITA For Practitioners, from XML Press,
http://xmlpress.net/publications/dita/practitioners-1/

Attachment: org.dita.doctypes.learning-WEK-2013-06-04-V6.zip
Description: org.dita.doctypes.learning-WEK-2013-06-04-V6.zip



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]