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

[caroline arms]

Murata-san.

I'm glad my suggestions helped.

I would adjust "a string consisting from name characters as defined in XML"
slightly to
"a string consisting of name characters as defined for XML."   Should there
be a pointer to an XML reference here?

    Regards, Caroline

On Tue, Jan 23, 2018 at 1:03 AM, MURATA Makoto <eb2m-mrt at asahi-net.or.jp>
wrote:

> 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/785784cd/attachment.html>