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

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

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


Subject: subjectScheme and normative language


The spec does not use any normative language concerning our expectations regarding processors and subject scheme maps. I think we need to consider changing this, especially as DITA 1.3 will introduce @deliveryTarget and deprecate @print.

Here are some changes for us to consider:

DITA 1.2 language
DITA 1.3 language (suggested)
Tools may validate controlled values for attributes by reference to the subject scheme map. Tools SHOULD validate controlled values for attributes by reference to the subject scheme map.
If controlled values for a metadata attribute are defined using the subject scheme map, tools may give an organization a list of readable labels, a hierarchy of values to simplify selection, and a shared definition of the value. If controlled values for a metadata attribute are defined using the subject scheme map, tools MAY give an organization a list of readable labels, a hierarchy of values to simplify selection, and a shared definition of the value.
The list of defined values are not validated by basic XML parsers. Instead, the defined values should be validated by DITA processors. The list of defined values are not validated by basic XML parsers. Instead, the defined values SHOULD be validated by DITA processors.
Processors should be aware of hierarchies of attributes defined in subject scheme maps, and process them differently than they might if the attributes were not defined in a hierarchy. Processors SHOULD be aware of hierarchies of attributes defined in subject scheme maps, and process them differently than they might if the attributes were not defined in a hierarchy.
If any other values are encountered [other than those defined in the subject scheme as valid for the attribute], processors validating against the scheme should give a warning If any other values are encountered [other than those defined in the subject scheme as valid for the attribute], processors validating against the scheme SHOULD give a warning
An enumeration may be defined with hierarchical levels by nesting subject definitions. If filtering or flagging excludes "therapist" and does not explicity identify "novice", processing should apply filtering to all subsets of therapist. If filtering includes "novice" but does not explicity exclude "therapist", processing should include the general therapist content because it applies to "novice". If flagging explicity includes "therapist" but is not set explicity for "novice", processing should apply the "therapist" flag to the "novice" content as a special type of therapist. An enumeration can be defined with hierarchical levels by nesting subject definitions. If filtering or flagging excludes "therapist" and does not explicity identify "novice", processing SHOULD apply filtering to all subsets of therapist. If filtering includes "novice" but does not explicity exclude "therapist", processing SHOULD include the general therapist content because it applies to "novice". If flagging explicity includes "therapist" but is not set explicity for "novice", processing SHOULD apply the "therapist" flag to the "novice" content as a special type of therapist.

Important caveat: This needs to be rewritten so that the normative language is separated from the example. And we should fix the typo also :)

Thoughts?

--
Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 682-2290; kriseberlein (skype)



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