Stack Exchange network consists of 183 Q&A communities including Stack Overflow, the largest, most trusted online community for developers to learn, share their knowledge, and build their careers.
@Kevin - I was actually hoping for both. The help?json would return formalized list of all available API methods; the help?/method?method=...&json would return a formalized description of the parameters.
I was thinking about building a console-type app, that uses the JSON representation of the help for autocomplete and for showing a plain text help in the app. Another scenario would be automatic proxy building against newer version of the API. In general, a JSON representation of the help can help with any scenarios where one needs automated API discovery/enumeration, kind of like a JSON WSDL.
Well, the obvious one would be SmallTalk, wouldn't it? After all, it's all about passing messages related to programming... :-) Unfortunately, that domain is taken by a squatter. :-(
I just wanted to give the OP a slightly different perspective. When you ask somebody to give their hard work for free to benefit others, you also need to consider what the impact on them is.