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

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

            Bug ID: 28019
           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: Functions and Operators 3.1
          Assignee: mike@saxonica.com
          Reporter: patrick@durusau.net
        QA Contact: public-qt-comments@w3.org

Same issue as 28018 but different component and different occurrences of the
same issue.

1.1 Conformance provides in part: "In this document, text labeled as an example
or as a Note is provided for explanatory purposes and is not normative."

Which could work except that there are 199 instances of the phrase "for
example" in the document, which I assume report non-normative information in a
normative context. It isn't clear. 

If any or all of those instances are "examples," they need to be labeled as
such and separated from normative text. 

Morover, all of the labeled examples are unnumbered and many of them are
multi-part examples, making clear reference to a part of an example
problematic. 

All examples should be labeled as such, numbered and where appropriate, given
sub-example numbering for ease of reference.

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

Received on Friday, 13 February 2015 21:52:16 UTC