Yeah, that's what I've been poking at and the original start of this rather 
lengthy thread. Unfortunately, WADL, while it appears complete, is rather 
obnoxious for pulling out data. Or more accurately, I haven't fully understood 
the WADL specification in order to write a WADL parser to allow me to do just 
that. I'm poking at it now, but my original goal wasn't to write an XML parser 
but to just create a unified API documentation set on a web site to make it 
easier to consume OpenStack services.

-joe

On Oct 27, 2011, at 8:04 AM, Lorin Hochstein wrote:
> It would be great if we could do some kind of transform of the IDL to 
> generate (some of) the human-consumable REST API documentation that lives at 
> docs.openstack.org. That would simplify the task of keeping those docs up to 
> date.
> 
> Lorin
> --
> Lorin Hochstein, Computer Scientist
> USC Information Sciences Institute
> 703.812.3710
> http://www.east.isi.edu/~lorin
> 
> 
> On Oct 27, 2011, at 9:54 AM, Sandy Walsh wrote:
>> Sounds awesome!
>> 
>> I've done an application like this in the past where an entire web UI was 
>> data driven using a custom IDL. It had to have presentation hints associated 
>> with it (acceptable values, display widget, etc). Not something WADL 
>> supports inherently I'm sure. But, I know from experience this can work.
>> 
>> I don't really care what the IDL is, so long as we don't have to write a 
>> parser for it in 10 different languages ... which is why XML/JSON hold such 
>> appeal (although JSON in C keeps me awake at night).
>> 
>> -S
>> 
>> ________________________________________
>> From: Mark Nottingham [m...@mnot.net]
>> Sent: Thursday, October 27, 2011 10:38 AM
>> To: Sandy Walsh
>> Cc: Mellquist, Peter; Joseph Heck; openstack@lists.launchpad.net
>> Subject: Re: [Openstack] +1,  All services should have WADLs
>> 
>> I'm totally on board with having the interface being machine-consumable at 
>> runtime -- see the previous discussion on versioning and extensibility -- 
>> but WADL isn't really designed for this. I'm sketching up something more 
>> appropriate, and will be able to talk about it soon (hopefully).
>> 
>> 
>> _______________________________________________
>> Mailing list: https://launchpad.net/~openstack
>> Post to     : openstack@lists.launchpad.net
>> Unsubscribe : https://launchpad.net/~openstack
>> More help   : https://help.launchpad.net/ListHelp
> 
> _______________________________________________
> Mailing list: https://launchpad.net/~openstack
> Post to     : openstack@lists.launchpad.net
> Unsubscribe : https://launchpad.net/~openstack
> More help   : https://help.launchpad.net/ListHelp

_______________________________________________
Mailing list: https://launchpad.net/~openstack
Post to     : openstack@lists.launchpad.net
Unsubscribe : https://launchpad.net/~openstack
More help   : https://help.launchpad.net/ListHelp

Reply via email to