Ross McDonald

docathon - overhaul documentation for 0.12.0+

2

- streamline getting started - choose a methodology where a bundled sim is not used - consolidate over sample-petstore and petstore-demo (they seem to be almost the same thing barring...

encode responses correctly according to request accept header etc

1

we currently ignore a range of content-type/accept inputs

could cover simple usecases where we want a little state in our free out of the box sims could result in some disk write access (enduro, or other) would cover...

add configurable behaviour for out of the box sim on success and error responses

5

currently we randomly select a success response it would be useful if we could configure a more reproducible behaviour e.g. selecting the first success response defined in the codex this...

not sure what we might want to filter on at this point, but it seems wasteful to only be able to return the full analysis over the wire

add HATEOAS discoverability links from responses to enable graph traversal

4

we can currently get a location header out of a POST response, we should enable other methods for discoverability