RE: Rework on SOAP 1.2 Part 2: Section 2 and 3

Stuart Williams writes: 

>>  The first sentence states: "Each graph edge is encoded 
>> as an element information item and each 
>> element information item represents a graph edge."

...

>>  The contractiction arises from the first entry
>> in the itemised list that follows: "...then 
>> the element information item is said to represent 
>> a node in the graph and the edge terminates at that 
>> node."
>> This now states that element information items can 
>> also represent graph nodes - contraticting the 
>> initial sentence.

I see what concerns you.  I suppose the first two paragraphs might be 
reworked as follows:

<original>
Each graph edge is encoded as an element information item and each element 
information item represents a graph edge. 3.1.3 Encoding compound values 
describes the relationship between edge labels and the local name and 
namespace name properties of such element information items. 

The node at which an edge terminates is determined as follows:
</original>

<proposed note="includes a bit of other cleanup">
Each graph edge is encoded as an element information item. The 
representation of outbound edges is described in 3.1.3 Encoding compound 
values.  That section describes the relationship between edge labels and 
the local name and namespace name properties of such element information 
items. 

Each element information item represents (a) a graph edge, as described 
above, and (b) optionally, a node at which that edge terminates.  Nodes 
and their associated inbound edges are encoded as follows:
</proposed>

I'm a bit torn as to which formulation I prefer.  The latter is more 
explicit, more clearly balances the presentation of inbound and outbound 
edges, and probably deals with your concern.  The original is a bit 
shorter and crisper.  Opinions?

------------------------------------------------------------------
Noah Mendelsohn                              Voice: 1-617-693-4036
IBM Corporation                                Fax: 1-617-693-8676
One Rogers Street
Cambridge, MA 02142
------------------------------------------------------------------

Received on Friday, 15 March 2002 12:31:42 UTC