PLEASE REVIEW: Comments on SOAP Resource Rep Header doc

{note to self: When this is ready to go, it should be sent to
xmlp-comments@w3.org}

The Internationalization Web Service Task Force (I18n WSTF) of the
Internationalization Working Group (I18n WG) have reviewed the SOAP
Resource Representation Header document and have the following questions
and comments.

1. In what scenarios would this header be used?  In other words, what
prompted the creation of this document?

2. What happens when you have the SOAP document in one charset and the
SOAP RRH with a text document in another charset?  We recommend that
charset issues be discussed in the document.

3. Related to the above question, we recommend that either:
	a. text transport should be restricted, or
	b. a recommendation against text transport this way should be included, or
	c. the base64 requirement should be relaxed.

4. URI is not defined in this document.  We recommend that the reference
  be IRI, and be defined as {fill in the definition - Martin?}.

5. How are the URIs matched?  For example, are they case-sensitive?

6. To avoid requiring that all SOAP senders understand the HTTP caching
mechanism, we recommend that all the data required by a processor that
wants to act as a local cache needs to be carried along with the
message. This includes the complete request/reply as well as the time
the original HTTP request has been sent and the time the HTTP response
has been received.

7. How are error conditions handled?  For example, what to do in the
case of an HTTP 404?

Below are some basic edits:

2.1 Introduction
----------------

occurences => occurrences (2 places)
several representation => several representations


2.2.1 rep:Representation element
--------------------------------

"One or more attribute information items amongst its [attributes]
property as follows:"
=>
"One or more attribute information items amongst its [attributes]
properties as follows:"
(not clear as written, is it an "attributes property"?  If so, it can't
be "amongst" a single thing.  Same comment for section 2.2.4)

"One or more element information items in its [children] property in
order as follows:"
=>
"One or more element information items in its [children] properties in
order as follows:"
(not clear as written, is it a "children property"?)

"with a [namespace name] different than"
=>
"with a [namespace name] different from"


2.2.4 rep:Data element
----------------------
(Same comments as in 2.2.1)


2.3 Extensibility of the Representation header block
----------------------------------------------------
"several possible usage" => "several possible usages"


2.3.3 HTTP headers
------------------
"... all SOAP senders understand HTTP caching mechanism"
                                 ^the


Regards,
Andrea Vine
W3C I18n WSTF

Received on Thursday, 26 August 2004 23:12:38 UTC