[OASIS Issue Tracker] (OBIX-239) Text is not clear

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

    [ https://issues.oasis-open.org/browse/OBIX-239?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=59391#comment-59391 ] 

Craig Gemmill  commented on OBIX-239:
-------------------------------------

MAY is capitalized simply because I was trying to reflect that I was allowing behavior, my understanding was that keywords like this should always be capitalized so it is clear they are being used in the context of specification behaviors.  If it's inappropriate to have it, I'm fine with lower-casing it.

'source' means the source being referenced, not anything obix.  I.e., if we're referencing Haystack, the Haystack dictionary that this OBIX Server uses is the "source", so we are talking about the version of that dictionary.  That is a bad example, because Haystack provides no version info.  But it is expected that other things like bindings would provide version info.  And even for the Haystack dictionary we can provide retrieval date, so we could potentially compare them.


> Text is not clear
> -----------------
>
>                 Key: OBIX-239
>                 URL: https://issues.oasis-open.org/browse/OBIX-239
>             Project: OASIS Open Building Information Exchange (oBIX) TC
>          Issue Type: Bug
>          Components: OBIX 1.1 Specification
>    Affects Versions: OBIX 1.1 WD39
>         Environment: William Cox Line 879-884
>            Reporter: William Cox
>            Assignee: Craig Gemmill 
>            Priority: Minor
>
> The non-normative section has MAY keyword on line 879, which seems odd - why is permission given in a non-normative section?
> Line 884 "...the source" it is not clear whether that should be "the source object"or "the source Object" or something else.



--
This message was sent by Atlassian JIRA
(v6.2.2#6258)