|Subject:||[tag] RE: May24 TAML PDF review - Update|
|From:||Dennis E. Hamilton (denn...@acm.org)|
|Date:||May 26, 2011 8:43:35 pm|
On p.6, last paragraph of section 2.1, I now wonder about the use of "declared"
for elements. I think elements are expressed. I think this might do better:
"Elements 'testAssertion', 'testAssertionSet', and 'testAssertionDocumentHeader'
are global elements and can be top-level elements in a TAML markup instance
(e.g., be root elements of an XML document). All other TAML elements are local
in a markup instance under the TAML schema (i.e., are descendant children of a
global element as provided by the schema).".
On page 7, new text about extensions near the top of the DIFF page. There are a
couple of things. In the second section, I think "At the exception ..." should be "With the
exception ... ."
The last sentence of the addition begins with "Note that ..." and then has a
normative statement. That sentence can be removed.
With regard to the allowance of TAML markup in <taml:common>, ...
<taml:comment>, and the restriction on child elements, I think a better wording
is needed. I will look at that separately.
On p.7 last sentence, "relative of their containing element" should be "relative
to their containing element"
p.8 Example - there should be a non-normative reference to the NIEM
specification. Thanks for expanding the abbreviation. Is there a specific
specification that can be referenced in the non-normative section?
p.10 top of page, this is talking about the <derivedSourceItem> element but
there is no accompanying Compact Relax NG definition as a lead-in. There seems
to be somethiing out of order here, in comparison to how all of the other
notions have a preceding Compact Relax NG definition that is further explained
with subsequent prose.
p.10 Starting with the Compact Relax NG definition for <taml:comment>, the
descriptive text is now in front of the Relax NG rather than after it as in the
preceding descriptions. I suggest that the description be after the Compact
Relax NG definition for the respective element. (That is, the new paragraphs
are good but should be after the Relax NG.) I must have misled you with one of
my previous coments.
p.14 2.3.10 second paragraph below the schema. HTML cannot be used. HTML
markup is not well-formed XML, doesn't have namespaces, etc. Try "can be a
mixture of text and XML elements."
p.15 first sentence below the bulleted list. I don't think we should allow
unqualified further values to be added. We should use the same QName condition
that is used for extensions to the value of 'label'.
pp.14. <taml:tag> is an element. I just noticed that it has an @name
attribute. Is this defined the same way as the other use of @name, and if not,
shouldn't we differentiate them (for future cases where we want to allow
taml:name in non-TAML instances, such as RDF).
I think this should reference section 2.5.
pp. 17-18. Section 2.5.1 I don't understand how or why we are lapsing into
this notation, which is not used anywhere else for TAML.
Shouldn't we just say that NormativeProperty is a reserved taml:tag/@name value,
and what the text of the element signifies?
LIkewise with 2.5.2. And in the definition for taml:tab/@name="VersionDrop" I
think the definition is not accurate (e.g., a number lower than VersionAdd would
qualify). Perhaps "the numerical version number, if any, beyond which the test
assertion does NOT apply".
** end of second-review notes **
--------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php