Create a more formal "Specification" Markdown file for our existing resource-type and location oriented API specs

[cookeac]

The current API specs are documented in OpenAPI specification, but the other expectations for them are in the Wiki.
The Wiki is not versioned, so changes to the expectations are not captured from release to release.

We should create a specification document as was done for the streaming API, and save this as a .md file in the repository. This could make use of content from the Wiki (for instance, fault tolerant reader pattern, identifer types, how batch methods work).

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[cookeac]

Resolved by #311 - see /docs/location-based-api.md