W3C home > Mailing lists > Public > public-rdf-dawg-comments@w3.org > October 2005

Re: WSDL comments on SPARQL Protocol LC Draft

From: Kendall Clark <kendall@monkeyfist.com>
Date: Wed, 26 Oct 2005 10:57:10 -0400
To: Jonathan Marsh <jmarsh@microsoft.com>
Cc: DAWG Mailing List <public-rdf-dawg-comments@w3.org>
Message-ID: <20051026145710.GE16381@monkeyfist.com>

On 14:21, Tue 25 Oct 05, Jonathan Marsh wrote:
> 
> During our review of the SPARQL LC draft, the WSDL WG identified three
> editorial items worthy of comment:
> 
> - the WSDL extract "1.0" uses two undeclared namespace prefixes "st:"
> and "tns:", actually 'st:' is used throughout the document. Although the
> reader is pointed to the full WSDL "which contains the relevant
> namespace declarations", we are becoming accustomed to a convention that
> lists a table of namespaces in use, and their associated prefixes within
> the document, at the top of the document, and feel readers would prefer
> to see this convention followed in the SPARQL spec as well.
> 
> - the status discusses "HTTP and SOAP interfaces for RDF queries" but
> elsewhere uses "HTTP and SOAP bindings of this interface", which could
> be slightly confusing for readers versed in WSDL speak.
> 
> - the document relies upon the reading of several external documents - a
> WSDL and a pair of schemas, the links of which are buried in the
> document. In the case of the schemas you have to hop through their
> namespace documents. It would be nice to have a separate table calling
> out these links so users could see the set of documents comprising the
> SPARQL protocol in one place.

Jonathan,

All of these seem editorial to me, and I'm convinced by the arguments such
that I will make changes along these lines to the protocol spec.

Cheers, 
Kendall Clark
--
Sad songs and waltzes aren't selling this year... --Cake
Received on Wednesday, 26 October 2005 14:59:46 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 8 January 2008 14:14:49 GMT