W3C home > Mailing lists > Public > public-qt-comments@w3.org > November 2016

[Bug 30022] New: [xdm 3.1] minor editorial changes in introduction and conformance

From: <bugzilla@jessica.w3.org>
Date: Tue, 29 Nov 2016 07:17:01 +0000
To: public-qt-comments@w3.org
Message-ID: <bug-30022-523@http.www.w3.org/Bugs/Public/>
https://www.w3.org/Bugs/Public/show_bug.cgi?id=30022

            Bug ID: 30022
           Summary: [xdm 3.1] minor editorial changes in introduction and
                    conformance
           Product: XPath / XQuery / XSLT
           Version: Member-only Editors Drafts
          Hardware: PC
                OS: Linux
            Status: NEW
          Severity: minor
          Priority: P2
         Component: Data Model 3.1
          Assignee: ndw@nwalsh.com
          Reporter: liam@w3.org
        QA Contact: public-qt-comments@w3.org
  Target Milestone: ---

All very minor issues.

1. [introduction] [[ The data model is based on the [Infoset] (henceforth
"Infoset"), but it requires the following new features to meet the [XQuery 3.1
Requirements]: ]]

The features listed are not new to XQuery 3.1. It's also not true (e.g. we
treat text nodes differently, and the XML Information Set is, strictly
speaking, a glossary and not a data model).

Suggest [[
The data model describes items similar to those of the [Infoset] (henceforth
"Infoset").  It is written to provide a data model suitable for XPath, XQuery
and XSLT, which was not a goal of the Infoset, and this leads to a number of
differences, some of which are:
]]


2. [introduction] The bullet list, 1st item, mentions ... "that extend the XML
Information Set" and should say Infoset.

3. s/accessible, but it does not specify/accessible but does not specify/
(the Infoset also doesn't specify this)

4. [[ Every node is one of the seven kinds of nodes defined in 6 Nodes ]] Erm,
seven or six?
Oh wait, it's a link to section 6. Boy, that's confusing! Maybe add the word
"Section" before the link?

5. [Definition: the root node...] doesn't start a paragraph.

6. In 2.1.1 last bullet, add a coma after xs:untypedAtomic, since it's not a
union type.

7. in 2.5 Sequences I read, "A sequence may contain any mixture of nodes,
functions, and atomic values" - what about arrays and maps? (arguably they are
derived from functions so maybe this is OK, but I think that fact would
surprise many readers so it may be worth drawing out in a note)

8. the inheritance diagram XPathTypeHierarchy-3-anyAtomicTypes-3.1.png doesn't
seem to mention xs:error



Conformance - maybe add a note about xml:id and xml:base support being
required? (this follows from the other specs I think)

-- 
You are receiving this mail because:
You are the QA Contact for the bug.
Received on Tuesday, 29 November 2016 07:17:10 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 16:58:03 UTC