Clause 8.5.2 (thoughts based on your online draft as of 1/22)

MURATA Makoto eb2m-mrt at asahi-net.or.jp
Tue Jan 23 07:03:34 CET 2018


Caroline,

Thanks again.

2018-01-23 10:31 GMT+09:00 caroline arms <caroline.arms at gmail.com>:

> Murata-san,
>
> Here are a few thoughts on 8.5.2
>
> 1.
> I would give this new normative subclause a slightly more helpful heading
> -- perhaps Relationship Structure.
>
> Done.


> 2.  Your 3rd paragraph is
>
> The *target mode* of a relationship shall be either internal or
> external.  The target shall be an external resource exactly when the target
> mode is external.
>
> I'm not sure the second sentence is necessary. It certainly reads
> awkwardly.   If needed, it might be better as:
> If the target is an external resource, the target mode shall be external.
>
>
I created two sentences.  One is for "internal", while the other is for
"external".


> 3.  The last paragraph has a couple of problems.
> a) In "unique within the relationships from the same part" I would use
> "among" rather than "within" because "relationships" is plural.
>

Done.


>
> b)  The first sentence is "The identifier of a relationship shall be a
> name."  But "name" might suggest something like a "part name" to someone
> who has just read earlier parts of clause 8.  I see that values for an
> identifier are constrained to 'the xsd:ID simple type of the W3C
> Recommendation "XML Schema Part 2: Datatypes."'  I checked this normative
> reference and learned that values for xsd:ID must be an NCNAME.  I had to
> look at the productions for both XML NCName and XML Name to really
> understand what is going on at a conceptual level.  Your use of "name"
> probably reflected that it has to be an XML Name, but that wasn't obvious
> to me.   I'd like to find a way to qualify or expand on "name" in a way
> that doesn't get too much into the weeds or find another term.  At
> http://www.datypic.com/sc/xsd11/t-xsd_ID.htmlI find " An xsd:ID value
> must be an NCName. This means that it must start with a letter or
> underscore, and can only contain letters, digits, underscores, hyphens, and
> periods"
> Could we take advantage of this less formal definition for 8.5.2?  Or
> could we just use "string"?
>

I wrote "a string consisting from name characters as defined in XML"

>
> The italics, etc. will need checking.  "The" at the beginning of the 4th
> paragraph is italicized.
>
>
Done.


>       I hope this helps.
>

Very helpful.  Thanks.

Regards,
Makoto

>
>        Caroline
>
>
>
>
>


-- 

Praying for the victims of the Japan Tohoku earthquake

Makoto
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mailman.vse.cz/pipermail/sc34wg4/attachments/20180123/3b5b1dde/attachment-0001.html>


More information about the sc34wg4 mailing list