changeset 2:4cda788d7ada

historical
author Henry S. Thompson <ht@inf.ed.ac.uk>
date Sat, 21 Oct 2023 16:09:52 +0100
parents 92618ff70952
children 11c0afd7bad2
files draft-ietf-clude-data-model-schema-14_review.txt
diffstat 1 files changed, 61 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/draft-ietf-clude-data-model-schema-14_review.txt	Sat Oct 21 16:09:52 2023 +0100
@@ -0,0 +1,61 @@
+Document: draft-ietf-clue-data-model-schema
+Title: An XML Schema for the CLUE data model
+Reviewer: Henry S. Thompson
+Review Date: 2016-05-11
+IETF Last Call Date: 2016-05-23
+
+Summary: The XML Schema itself which is included in this draft is
+conformant to the XML Schema 1.0 spec, and is good to go.  There is a
+minor glitch in one of the XML examples, easily corrected.
+
+Comments:
+
+I tested the XML Schema document included as section 4 and it passes as
+a valid against the schema for schemas.  The example document in section
+17 is schema-valid according to the corresponding schema.  See 'Nits'
+below for a minor problem with the example document in section 18.
+
+I briefly reviewed the schema document and it seems straightforward and
+fit for its intended purpose.
+
+Minor Issues:
+
+Section 4, lines 13--14:
+
+ <xs:import namespace="urn:ietf:params:xml:ns:vcard-4.0"
+ schemaLocation="xcard.xsd"/>
+
+As this stands, it's not actually usable for validation purposes,
+because no xcard.xsd file is supplied.  Furthermore, there is no
+Appendix A, which is alleged to provide it (see 11.29.1.2).
+
+I note further that the xCard RFC (6351) doesn't contain an XSD-format
+schema document either.  The IANA XML Registry [1] schema entry for the
+urn:ietf:params:xml:ns:vcard-4.0 URN namespace _does_ however link to
+such a schema document [2].  I suggest you either
+  a) Edit the draft so the above lines read
+
+ <xs:import namespace="urn:ietf:params:xml:ns:vcard-4.0"
+ schemaLocation="http://www.iana.org/assignments/xml-registry/schema/vcard-4.0.xsd"/>
+
+  (this is what I did to do the validity checks I did);
+
+or
+
+ b) Delete the schemaLocation attribute, add a comment identifying
+    possible sources of a schema document for the vcard-4.0 namespace,
+    e.g. the above iana.org URI or the contents of Appendix A (if you
+    fill it in).
+
+Nits:
+
+Section 18, the XML example has a (copy-paste?) error, which renders
+that example invalid against the schema.  The line
+
+             <encGroupIDREF>EG0</encGroupIDREF>
+
+appears twice inside mediaCapture VC7, once on line 204 and once on line
+237.  The first occurrence should be deleted.
+
+[1] http://www.iana.org/assignments/xml-registry/xml-registry.xhtml#schema
+[2] http://www.iana.org/assignments/xml-registry/schema/vcard-4.0.xsd