Uploaded image for project: 'OASIS Open Building Information Exchange (oBIX) TC'
  1. OASIS Open Building Information Exchange (oBIX) TC
  2. OBIX-237

Line 950ff Reference for Relative URIs

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Minor
    • Resolution: Fixed
    • Affects Version/s: OBIX 1.1 WD39
    • Fix Version/s: OBIX 1.1 WD43
    • Component/s: OBIX 1.1 Specification
    • Labels:
      None
    • Environment:

      William Cox WD39 line 245, 950, 970,

    • Proposal:
      Hide

      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.

      Show
      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.
    • Resolution:
      Hide

      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.

      Editor review and correct as needed.

      Show
      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. Editor review and correct as needed.

      Description

      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

        Attachments

          Activity

            People

            • Assignee:
              william.cox William Cox (Inactive)
              Reporter:
              william.cox William Cox (Inactive)
            • Watchers:
              3 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: