Which of Swagger or WADL is recommended for smartdocs

I usually use WADL for my smart docs, since I have been using them for API Consoles.

I started learning Swagger now, and using it more in the context of Apigee 127.

Is there a specific advantage or recommendation of using one vs the other for smartdocs?

1 Like

I don’t think there are any advantages from SmartDocs perspective as it behaves the same for both WADL /Swagger. But I personally prefer Swagger because of the following advantages -

  • provides a bunch of tools for easy & quick development.
  • helps me generate both client and server side and also documentation for my APIs.
  • supports vendor extensions
  • supported by industry leaders in the API management
  • backed by a large developer communit
1 Like