[Bug 27040] New: Use the word "identity" in its ordinary English meaning

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

            Bug ID: 27040
           Summary: Use the word "identity" in its ordinary English
                    meaning
           Product: XPath / XQuery / XSLT
           Version: Last Call drafts
          Hardware: PC
                OS: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Data Model 3.1
          Assignee: ndw@nwalsh.com
          Reporter: cmsmcq@blackmesatech.com
        QA Contact: public-qt-comments@w3.org

Created attachment 1522
  --> https://www.w3.org/Bugs/Public/attachment.cgi?id=1522&action=edit
List of changes proposed

Most uses of the words "identity" and "identical" in our specs make sense to
readers who approach them from the ordinary English meanings of the words; a
few uses rely on a specialized usage of the terms which some WG members have
reported is common in discussions of object-oriented programming.  Those
passages make very little sense to readers who endeavor to understand them
using the ordinary tools for establishing the meaning of words in a text, like
dictionaries.

I propose that we reword some sections of our specifications to avoid relying
on domain-specific meanings for terms not defined in our specifications.

I am opening this bug against XDM, but in fact the passages I believe we should
change appear also in Functions and Operators, XQuery, XSLT, and XQuery
Requirements and use cases; some passages in XPath might also be rephrased but
I don't think they are urgent.

Attached is a list of passages I believe should change and proposed wording for
each of them.

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

Received on Tuesday, 14 October 2014 02:23:45 UTC