W3C home > Mailing lists > Public > public-web-http-desc@w3.org > August 2006

Is it a good idea to make your WADL available?

From: Mark Nottingham <mnot@yahoo-inc.com>
Date: Thu, 31 Aug 2006 13:02:30 -0700
Message-Id: <E245BFA5-E414-4D00-B6E4-3B5EE1FA3C0B@yahoo-inc.com>
To: public-web-http-desc@w3.org

As I've said before, my primary use cases for WADL (and other desc  
formats) are
   a) as a design-time aid
   b) for documentation generation
   c) for server and intermediary configuration
and possibly also for stub generation on the server side.

Talking to folks about this, I'm starting to wonder if there are  
*any* good use cases for sharing your Web description with clients,  
because doing so risks engendering tight coupling.

The only exception I can think of right now is when you can do some  
client-side optimisation (e.g., having hints about whether the  
service supports chunked/compressed request bodies). However, that  
information can be made available elsewhere (e.g., OPTIONS extensions).


Of course, we can't stop people from misusing description, but I'd  
like to have the clearest, strongest guidance possible available and  
well-known, so this doesn't lead people down the same path that WS-*  
took (to parrot one concern I've heard).


Mark Nottingham
Received on Thursday, 31 August 2006 20:03:30 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 19:47:19 UTC