[Bug 30026] New: Misc Editorial Comments

https://www.w3.org/Bugs/Public/show_bug.cgi?id=30026

            Bug ID: 30026
           Summary: Misc Editorial Comments
           Product: XPath / XQuery / XSLT
           Version: Candidate Recommendation
          Hardware: PC
                OS: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: XQuery 3.1
          Assignee: jonathan.robie@gmail.com
          Reporter: josh.spiegel@oracle.com
        QA Contact: public-qt-comments@w3.org
  Target Milestone: ---

(Jonathan) Abstract should mention JSON.

---

(Jonathan) The introduction does not mention JSON.

----

(Jonathan) [Definition: XQuery 3.1 operates on the abstract, logical structure
of an XML document, rather than its surface syntax. This logical structure,
known as the data model, is defined in [XQuery and XPath Data Model (XDM)
3.1].]

Scope of XDM has increased.


------------------

(Rest are for Josh)


"XQuery also has an XML-based syntax, which is described in [XQueryX 1.0]."

Should be XQueryX 3.1

----

fn:data, fn:boolean: make the descriptions match FNO 

-----

(2.5.5.8) Map Test -> MapTest (linked) like in previous sections.  

(2.5.5.9) Same for Array Test.  "Wildcard Array Test" should be AnyArrayTest,
etc.   

  Add example with occurrence indicator where members aren't singletons. e.g.

     [(1,2),(3,4)] instance of array(xs:integer) returns false()
     [(1,2),(3,4)] instance of array(xs:integer+) returns true() 


(2.5.6.1) Table is difficult to read.  Can we reduce the text size and add more
formatting or something?  There used to be borders.  Same goes for tables in
logical expressions section.

3.1 Primary Expressions, last sentence of first paragraph, add String
Constructors. 

-----

Throughout the document, scraps of grammar productions now display "Grammar
Rules".  This never rendered before, can we remove it?

-----

(3.1.5.1) Inconsistent use of nonlocal vs non-local

-----

Delete this sentence: "Some primary expressions contain enclosed expressions."

-----

"In a direct element constructor, curly braces { } delimit enclosed expression,
distinguishing them from literal text. "

expression->expressions

-----

"A String Constructor is a constructor that creates strings using interpolated
expressions."

 - String Contructor -> StringConstructor
 - It creates *a* string

"A StringConstructor creates a string from literal text and interpolated
expressions."

-----

"To evaluate a string constructor, each sequence of adjacent string constructor
characters is converted to a string containing the same characters, and each
string constructor interpolation $i is evaluated, then converted to a string
using the expression string-join($i, ' '). "

After this sentence say:

Any string constructor interpolation that contains no expression (`{ }`) is
ignored. 

-----
Firefox OSX issue:
3.11.3.2 - why is KeySpecifier on a new line in the scrap? 
3.12.3 - let clause, ExprSingle looks like an unnecessary wrap
3.12.5 Where Clause (ExprSingle on new line)
3.12.6 Count Clause 
3.12.9 Return Clause 
3.14 Conditional Expressions 
(Chrome is ok)
-----

"Definition: An arrow operator applies a function to the value of a expression,
using the value as the first argument to the function."

*an* expression

-----

4.10 Decimal Format Declaration 
indenting in example is bad

-----

5.4
"a XQuery expression" -> "an XQuery expression"

-----

A.1 - ebnf looks squished.  Reduce font size.

-----

I.3 Recursive Transformations
Something is wrong with the rendering of examples in this section
Same for I.4 Selecting Distinct Combinations

-- 
You are receiving this mail because:
You are the QA Contact for the bug.

Received on Wednesday, 30 November 2016 18:13:52 UTC