Dec 26, 2011 at 9:33 PM
Edited Dec 26, 2011 at 9:34 PM
I've just created a WebApi REST site where my users "POST" a message to a URL. The content of the request is a json formatted string of key value pairs.
I'm looking for the best way to document the requirements.
WCF 4.0 implements "Help" in the rest services (http://msdn.microsoft.com/en-us/library/ee230442.aspx)
But this requires hosting with "WebServiceHost". With the "HttpServiceHostFactory" of WebAPI, I can find no way to utilize the "Help" documentation. Also I'm unsure of how to programatically show the requirements of this json string. That
might be a discussion for another thread however.
I have tried Autodocs (http://autodocs.codeplex.com) but it doesnt seem to work with WebAPI either and is so new that there is little/no support.
Does WebApi have any built in way to do documentation or how have you built docs for your WebApi apps?