W3C home > Mailing lists > Public > public-qt-comments@w3.org > February 2015

[Bug 28021] New: Normative vs. Non-Normative Text (Examples)

From: <bugzilla@jessica.w3.org>
Date: Fri, 13 Feb 2015 22:09:17 +0000
To: public-qt-comments@w3.org
Message-ID: <bug-28021-523@http.www.w3.org/Bugs/Public/>
https://www.w3.org/Bugs/Public/show_bug.cgi?id=28021

            Bug ID: 28021
           Summary: Normative vs. Non-Normative Text (Examples)
           Product: XPath / XQuery / XSLT
           Version: Candidate Recommendation
          Hardware: PC
                OS: Linux
            Status: NEW
          Severity: normal
          Priority: P2
         Component: XQuery 3.1
          Assignee: jonathan.robie@gmail.com
          Reporter: patrick@durusau.net
        QA Contact: public-qt-comments@w3.org

Same issue as 28018 but on a different component and with mostly different
occurrences.

I say "mostly" because the non-normative presentation of productions re-occurs
in this text:

***
In the grammar productions in this document, named symbols are underlined and
literal text is enclosed in double quotes. For example, the following
productions describe the syntax of a static function call:


[137]       FunctionCall       ::=       EQName ArgumentList
[121]       ArgumentList       ::=       "(" (Argument ("," Argument)*)? ")"
***

Moreover, there are 455 uses of the term "example," the vast majority of which
are not inside Notes nor are they labeled as Examples, to say nothing of being
unnumbered, which prevents precise referencing. 

All examples should be labeled, numbered and when multi-part, given sub-example
numbering.

-- 
You are receiving this mail because:
You are the QA Contact for the bug.
Received on Friday, 13 February 2015 22:09:19 UTC

This archive was generated by hypermail 2.3.1 : Friday, 13 February 2015 22:09:19 UTC