[Bug 8069] New: Enum: intro text needs updating

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

           Summary: Enum: intro text needs updating
           Product: WS-Resource Access
           Version: FPWD
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Enumeration
        AssignedTo: public-ws-resource-access-notifications@w3.org
        ReportedBy: dug@us.ibm.com
         QAContact: public-ws-resource-access-notifications@w3.org


In the intro of WS-Enum there's a bit that says:

In its simplest form, WS-Enumeration defines a single operation, Pull, which
allows a data source, in the context of a specific enumeration, to produce a
sequence of XML elements in the body of a SOAP message.

In the submitted version of the spec this was true because Enumerate() was
not required to be supported.  In the latest version of the spec Enumerate()
is no longer optional.  So the above paragraph should be changed to something
more like:

In its simplest form, WS-Enumeration defines an operation, Enumerate, used to
establish the creation of an enumeration session and a single operation, Pull,
which allows a data source, in the context of a specific enumeration, to
produce a sequence of XML elements in the body of a SOAP message.

Also, in the next paragraph, there's a sentence that reads:
This specification defines such an operation, Enumerate, that data sources MAY
implement for starting a new enumeration of a data source.

Based on recent changes the MAY should be a MUST.

Proposal: see above


-- 
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, 26 October 2009 13:53:02 UTC