What's the best tool to manage documentation for Restful API?

Question

I'm building a RESTful API in ASP.NET. I'd like to document its features with a tool that will keep all the functionality and actions organized and grouped for easy editing and can export the documentation in various formats (HTML, PDF).

I'm not looking for an auto-generating script that will parse my code - especially since the internal methods and properties would be mostly meaningless for the end users of the API.

Answer 1

Unfortunately I don't know anything specific that will help you in ASP.NET -- However just as points of reference, you might take a peek at the WADL specification that the JAX-RS java spec is using -- https://wadl.dev.java.net/ -- Additionally, there is a xslt that will transform the wadl into html -- http://www.mnot.net/webdesc/