OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

obix message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


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


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

William Cox updated OBIX-237:
-----------------------------

    Proposal: 
Correct per Description.

A first reference should be earlier in the document than section 6, as the examples are confusing without understanding that typically relative URIs are used.

Also, same reference for URI Fragments.

  was:
Correct per Description.

A first reference should be earlier in the document than section 6, as the examples are confusing without understanding that typically relative URIs are used.


> 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)


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]