[Bug 11849] New: optionality language on mex:MetadatSection/@mex:Dialect is not clear

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

           Summary: optionality language on
                    mex:MetadatSection/@mex:Dialect is not clear
           Product: WS-Resource Access
           Version: LC
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: MetadataExchange
        AssignedTo: public-ws-resource-access-notifications@w3.org
        ReportedBy: gilbert.pilz@oracle.com
         QAContact: public-ws-resource-access-notifications@w3.org


The first paragraph of the description of mex:MetadataSection/@mex:Dialect
reads:

"This indicates the type and version of the metadata unit contained in this
MetadataSection (e.g., WSDL version 1.1). This MUST be the QName of the root
element of the metadata."

It's not clear from this description that @Dialect is a required attribute. The
"MUST" in the second sentence could be read as applying to the value of the
attribute if and only if the attribute is present.

Proposal - replace the first sentence with the following:

"This REQUIRED attribute indicates the type and version of the metadata unit
contained in this MetadataSection (e.g. WSDL version 1.1)."

-- 
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.

Received on Monday, 24 January 2011 22:22:47 UTC