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

[Bug 28023] New: Missing RFC 2119 and adherence to RFC 2119

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

            Bug ID: 28023
           Summary: Missing RFC 2119 and adherence to RFC 2119
           Product: XPath / XQuery / XSLT
           Version: Candidate Recommendation
          Hardware: PC
                OS: Linux
            Status: NEW
          Severity: normal
          Priority: P2
         Component: XPath 3.1
          Assignee: jonathan.robie@gmail.com
          Reporter: patrick@durusau.net
        QA Contact: public-qt-comments@w3.org

The text lacks any reference to RFC 2119 for requirements language, even though
RFC 2119 is cited in its references. 

Without normative invocation of RFC 2119, the meaning of "must" and other
requirements language is unknown. 

BTW, the use of lower case "must" in this document (some 104 times), leaves me
uncertain as to whether it was meant to be UPPERCASE MUST, which in RFCs
signals a requirement or was meant to be a lowercase must, which signals only
necessity.

I don't know the draft well enough to suggest which cases are which. 

The better convention is to follow the RFCs and use UPPERCASE MUST where a
requirement is being stated.

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

This archive was generated by hypermail 2.3.1 : Friday, 13 February 2015 22:25:04 UTC