issue 6719 - proposal (sort of)

Issue 6719 talks about the following piece of text in mex being unclear:

/mex:Metadata/mex:MetadataSection/@Dialect 
="http://www.w3.org/2009/02/ws-mex" 
This value indicates the type of the metadata contained within the 
Metadata Section. When used in conjunction with Metadata Reference or 
Location, this allows the inclusion of metadata by reference. 

Which does seem a bit cryptic. I see two possible ways forward:

1 - remove this entire chunk of text.  The preceding table lists a variety 
of Dialect URIs - why does MEX call out just this one for special 
treatment?

2 - call out this one dialect because its a bit different and not as 
obvious what it means - unlike easy ones like WSDL.  But, if we do keep it 
then we should modify the text to something more understandable.  Perhaps 
something like:
/mex:Metadata/mex:MetadataSection/@Dialect 
="http://www.w3.org/2009/02/ws-mex" 
When this Dialect URI is present it indicates that this Metadata Section 
contains a metadata unit corresponding to WS-MetadataExchange metadata. In 
other words, if this Metadata Section contained the representation of the 
metadata (instead of a reference), then the child element of this element 
would be <mex:Metadata>.

I have to say though, I'm having a hard time understanding when the 
metadata about a resource would be mex metadata.  Could someone explain 
the usecase for this?  Example 7-2 doesn't seem to help or make any sense 
to me.

If no one can justify it then option #3 is to remove the above text, 
remove the definition of this dialect from the preceeding table and remove 
example 7-2.

thanks
-Doug
______________________________________________________
STSM |  Standards Architect  |  IBM Software Group
(919) 254-6905  |  IBM 444-6905  |  dug@us.ibm.com
The more I'm around some people, the more I like my dog.