Line 950ff Reference for Relative URIs

XMLWordPrintable

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

      William Cox WD39 line 245, 950, 970,

    • 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.
    • 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.

      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

            Assignee:
            William Cox (Inactive)
            Reporter:
            William Cox (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: