[OASIS Issue Tracker] (OBIX-237) Line 950ff Reference for Relative URIs

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

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

William Cox commented on OBIX-237:
----------------------------------

Craig - thanks for the clarifications.

wrt 188 and 196:

That's the first occurrence of a relative URI, rather than an occurrence of "relative" - in a non-normative quick start a normative isn't possible, but not everyone recognizes relative URIs when the see them.  I'd suggest a footnote in the example pointing to Section 3.4.

> Line 950ff Reference for Relative URIs
> --------------------------------------
>
>                 Key: OBIX-237
>                 URL: https://issues.oasis-open.org/browse/OBIX-237
>             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 WD39 line 245, 950, 970, 
>            Reporter: William Cox
>            Assignee: Craig Gemmill 
>            Priority: Minor
>
> Relative URIs need a reference; it's already in the normative references. [RFC3986]. 
> URI Reference also should be cited at the first occurrence on line 245 [RFC3986] and at line 950 where it is italicized and apparently first defined.
> Line 952 is incorrect: a URI reference may be absolute or relative; text should read "...MUST be an absolute URI and NOT be a relative URI..." (Section 4.1 RFC3986). Explain on first use that "relative URI" is shorthand for "a relative URI reference" to improve understanding e.g. at line 196, as well as the scope of the relative URI reference and its base (apparently Line 188).
> This is especially important because this is in the non-normative Quick Start section so key terminology should be correctly explained



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