Re: [Mailman-Developers] Using REST Interface and WADL
Quoting Barry Warsaw <barry@list.org>:
On Apr 13, 2008, at 5:35 PM, Maki Kato wrote: [stuff deleted]
- Documentation. I'm hoping the xHTML representation will have
a way of being able to serve reasonable documentation. So one
could point their browser to the REST interface and start browsing
to learn how the server is implemented. We may want to distribute
a static set of HTML pages that has documentation and test(dummy)
data.Leonard Richardson is very hot on WADL. Will we be able to generate that automatically or does that not have a place in the architecture you're thinking about?
I went to read up some more on WADL and ran into this: http://bitworking.org/news/193/Do-we-need-WADL
I don't have any plans(yet) on auto generating the WADL, or did you
mean auto generating the documentation from the WADL file? Are there
tools that do that? I didn't find any such.
Currently I'm returning human readable text containing something like
documentation when you request the xHTML representation. I've seen
this done before and figured it was a pretty good idea. It is of no
use of course if you want to auto generate a client, as you would from
a description file.
Anyone else have any opinions or experiences with WADL?
....maki....
This message was sent using IMP, the Internet Messaging Program.
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
On May 6, 2008, at 12:53 AM, mk2s@digitalcommute.com wrote:
I went to read up some more on WADL and ran into this: http://bitworking.org/news/193/Do-we-need-WADL
Thanks, I hadn't seen that before.
I don't have any plans(yet) on auto generating the WADL, or did you
mean auto generating the documentation from the WADL file? Are
there tools that do that? I didn't find any such.Currently I'm returning human readable text containing something
like documentation when you request the xHTML representation. I've
seen this done before and figured it was a pretty good idea. It is
of no use of course if you want to auto generate a client, as you
would from a description file.Anyone else have any opinions or experiences with WADL?
I'm not aware of any tools to automatically build clients from a WADL
description. Personally, I'm rather skeptical it can be done, or at
least done well. I've had far too many experiences looking at
horrible generated code to have much hope of it being a fruitful
avenue. I really only asked because I've talked to a few other folks
about it w.r.t. different applications, so I was interested in getting
your opinion on it.
Thanks,
- -Barry
-----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.9 (Darwin)
iEYEARECAAYFAkgw2HsACgkQ2YZpQepbvXFo+gCcCmoC4z8/JelOWL5/Oqh0z0OW oW0AoLMj763toT/s21gQPjNYBDkywvDX =EPw+ -----END PGP SIGNATURE-----
participants (2)
-
Barry Warsaw -
mk2s＠digitalcommute.com