Some editorial issues with the Metadata document

    *  The introduction states that "Web Services Addressing 1.0 -
      Metadata (this document) defines how the abstract properties
      defined in Web Services Addressing 1.0 - Core are described using
      WSDL."  This is true but not complete, particularly since we now
      emphasize WS-Policy as well.
    * I believe this has already been done to death, but my $0.02 on
      table 3-1 is that it's not immediately clear what "REQUIRED"
      means.  I'd naively  think it meant that the MAPs are required,
      but that seems redundant in the row marked "yes" for MAPs in input
      message.  From the subsequent text I gather it means "you have to
      include the required MAPs."  Since the requirements are clearly
      spelled out in section 5, perhaps "see section 5", or "as per
      section 5" or such might be clearer.
    * In the text after the table, we might want to refer back to the
      place where we defined "WS-A is engaged".  Similarly "this
      specification" is a bit ambiguous.  I believe we mean either "the
      rest of the specification (core and SOAP)" or "the whole of WS-A"
      (including perhaps parts yet to be added on?), and not just the
      Metadata document.
    * The NOTE in section 3.2.3 after the first paragraph that if both
      anonymous and non anonymous responses are supported there should
      be a separate alternative including only anonymous responses
      consists of one long sentence with no punctuation making it fairly
      hard to parse but also lending it a certain Joycean quality which
      is to be commended.

Received on Monday, 8 January 2007 16:49:41 UTC