This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 30026 - Misc Editorial Comments
Summary: Misc Editorial Comments
Status: RESOLVED FIXED
Alias: None
Product: XPath / XQuery / XSLT
Classification: Unclassified
Component: XQuery 3.1 (show other bugs)
Version: Candidate Recommendation
Hardware: PC All
: P2 editorial
Target Milestone: ---
Assignee: Jonathan Robie
QA Contact: Mailing list for public feedback on specs from XSL and XML Query WGs
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2016-11-30 18:13 UTC by Josh Spiegel
Modified: 2016-12-06 16:28 UTC (History)
1 user (show)

See Also:


Attachments

Description Josh Spiegel 2016-11-30 18:13:44 UTC
(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