[Bug 29702] New: [XP31] Production rules in the text not unambiguous as a result of missing annotations

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

            Bug ID: 29702
           Summary: [XP31] Production rules in the text not unambiguous as
                    a result of missing annotations
           Product: XPath / XQuery / XSLT
           Version: Candidate Recommendation
          Hardware: PC
                OS: Windows NT
            Status: NEW
          Severity: editorial
          Priority: P2
         Component: XPath 3.1
          Assignee: jonathan.robie@gmail.com
          Reporter: abel.braaksma@xs4all.nl
        QA Contact: public-qt-comments@w3.org
  Target Milestone: ---

As a result of [1], [2], [3] and [4] and the resolution in [5], caused by
confusion about missing production annotations, the Joined WG asked me to write
an editorial bug about improving the production rules that appear within the
body of the specification.

The issue at hand: the production rules within the text do not maintain the
annotations in A.1 EBNF, which confuses competent readers.

Proposal (my recollection of discussion in telcon #647)

1) Remove the following sentence from A.1

"To increase readability, the EBNF in the main body of this document omits some
of these notational features. This appendix is the normative version of the
EBNF."

2) Update the stylesheets such that the annotations become part of the
productions within the text, so that they are normatively equivalent.

3) Leave section A.1 as the Normative EBNF.


[1] https://lists.w3.org/Archives/Public/public-xsl-query/2016Jun/0047.html
[2] https://lists.w3.org/Archives/Public/public-xsl-query/2016Jun/0049.html
[3] https://lists.w3.org/Archives/Public/public-xsl-query/2016Jun/0053.html
[4] https://lists.w3.org/Archives/Public/public-xsl-query/2016Jun/0056.html
[5] https://lists.w3.org/Archives/Public/public-xsl-query/2016Jun/0057.html

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

Received on Tuesday, 21 June 2016 15:59:38 UTC