Azure / Azure/azure-rest-api-specs
Missing API spec for Cosmos DB version 2020-11-05
- Dominant language
- TypeSpec
- Stars
- 3.1k
- Forks
- 5.9k
- Avg merge
- 2d 22h
- Merged PRs (30d)
- 444
Description
The API spec for version 2020-11-05 of the Cosmos DB API is missing (both from this repo and from the entire Internet). The only reason I know it exists is because this is what azure-sdk-for-go uses.
Is it possible to publish this spec here? I don't really understand why it's not documented. I understand that when possible, Microsoft's Cosmos DB SDKs do not use a REST API at all, but that doesn't seem like a reason to not publish the spec for the APIs that some do use. Not having machine-consumable documentation for the APIs the SDK is using is problematic for my use case.
Contributor guide
Research direction
No file, test, or entry point is named. Start by confirming the Cosmos DB API version 2020-11-05 and whether a source specification can be obtained from azure-sdk-for-go or Microsoft; done means the machine-consumable specification is published in this repository.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- azure
- Domain
- api, cloud
- Issue type
- Documentation
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 20/100