William Brogden wrote:
Recall that REST is an architecture / style - not a messaging API like SOAP.
You drove the nail on its head. Thanks !
Also, thinking more about it, the whole purpose of the discovery process is to establish the re-usability of the services in the inventory. So, a human readable document helps the cause even more to make better decisions compared to navigating through WSDLs, which at times stymies developers ! I think the intent then would be how great a document be produced compared to ones that will get generated from sporadic developer comments (akin to javadocs), which may not be at times explaining things clearly.
Swagger looks cool as well.