W3C home > Mailing lists > Public > public-sml@w3.org > May 2008

[Bug 5720] Inconsistent languge describing sml references and schemes

From: <bugzilla@farnsworth.w3.org>
Date: Wed, 28 May 2008 18:51:08 +0000
CC:
To: public-sml@w3.org
Message-Id: <E1K1Qjs-0001x6-Dh@farnsworth.w3.org>

http://www.w3.org/Bugs/Public/show_bug.cgi?id=5720

           Summary: Inconsistent languge describing sml references and
                    schemes
           Product: SML
           Version: LC
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Core
        AssignedTo: cmsmcq@w3.org
        ReportedBy: julia@us.ibm.com
         QAContact: public-sml@w3.org


The specification uses a variety of apparenly inconsistent phrases to describe
SML references, SML reference schemes, instances of SML reference schemes and
their relationships.  

Here are a few examples:
Section 4.2: An SML reference (element with sml:ref='true') is an instance of
an SML reference scheme 
Section 4.2.1 and 4.2.2: An SML reference contains an SML reference scheme 
Section 4.3: An SML reference is represented by reference schemes 
Section 4.1.3: "None of the recognized reference schemes resolves." 
Section 9.2.4: "sml:uri specifies an SML reference represented by the SML URI
reference scheme" 

I think new readers would be greatly helped if we settled on consistent
terminology to describe these concepts.
Received on Wednesday, 28 May 2008 18:51:42 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 28 May 2008 18:51:43 GMT