Tell me more ×
Stack Apps is a question and answer site for apps, scripts, and development with the Stack Exchange API. It's 100% free, no registration required.
up vote 1 down vote favorite
1

It would take a lot of the guess work out of sussing the api if each route's page provided a small handful of working urls.

This would also serve to provide an authoritative result exemplar.

share|improve this question

1 Answer

up vote 0 down vote accepted

This is going to have to wait until a 1.0 release, otherwise we're going to run the - quite high risk - of having bad examples laying around for new developers to trip over.

Pre-1.0 as much of the help as can reasonably be, will be built auto-magically.

share|improve this answer
are the results examples generated or composed? – Sky Sanders Jun 1 '10 at 7:02
@code poet - Only the descriptions (the first bullet point on Parameters, and the "description" key on Returns) are composed by a human. Everything else is automagically generated. The degree to which such information is intrinsic in the code itself varies somewhat. – Kevin Montrose♦ Jun 1 '10 at 7:10
this is good to know. gives me confidence that my efforts at automating are not likely to be obsoleted. as an aside - your quick efforts at fixing the docs broke my generator. I had to go in and remove special case code and un-fail tests. ;-) good job. – Sky Sanders Jun 1 '10 at 7:15
perhaps a wiki question with a disclaimer would be better than nothing, I can generate a starting set. – Sky Sanders Jun 2 '10 at 4:16

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged