Skip to main content
6 events
when toggle format what by license comment
Jun 1, 2010 at 7:37 comment added Sky Sanders Jeff- stackapps.com/questions/386/… , stackapps.com/questions/409/… and more on the way - this is why it would be very useful.
May 27, 2010 at 19:55 comment added Greg Bray Looks like I spoke too soon... the api.stackoverflow.com/0.8/help/method?method=stats version of the help page does use CSS and ID tags and should be much easier to parse.
May 27, 2010 at 19:43 comment added Greg Bray I could see a use for consuming the help file in a JSON format when creating a library or wrapper. Rather than re-type or copy and paste all the method descriptions you could pull down the help page and use code templates to prototype the method bodies with full documentation. I was planning on doing this by parsing the current HTML help pages, but while the HTML is very clean it does not use element IDs or CSS classes to annotate the methods very well so it is not very easy to scrape content from those pages.
May 25, 2010 at 9:32 comment added systempuntoout I think this should be added. I was thinking to build a Playground Stack WebApp that automatically retrieves all the methods available of a given API version, and let you play with them. Without the JSON representation help you don't have a valid entry-point to reach all the API methods automatically.
May 25, 2010 at 0:32 comment added Franci Penov 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.
May 25, 2010 at 0:25 history answered Jeff Atwood CC BY-SA 2.5