Azure / Azure/azure-cli

Extremely poor documentation for `az cosmosdb create`

Open
#16,583 33 comments 11 reactions 0 assignees View on GitHub
act-codegen-extensibility-squad CosmosDB feature-request Service Attention
Dominant language
Python
Stars
4.6k
Forks
3.5k
Avg merge
3d 2h
Merged PRs (30d)
60

Description

None of the parameters are documented on a sufficient level. For example:
```
--capabilities
Set custom capabilities on the Cosmos DB database account.
```
Not even a link where I can read further what are these mysterious capabilities.

```
--kind
The type of Cosmos DB database account to create.

accepted values: GlobalDocumentDB, MongoDB, Parse
default value: GlobalDocumentDB
```
What is `Parse` in this context?

```
--locations
Add a location to the Cosmos DB database account.
```
Luckily the actual help text (`--help`) explains how to set a location.

---
#### Document Details

⚠ *Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.*

* ID: abc8d652-2eda-296f-28ea-8d5f1ea855b3
* Version Independent ID: 80b87995-d339-61e9-1cac-b5c9ad6efe5e
* Content: [az cosmosdb](https://docs.microsoft.com/en-us/cli/azure/cosmosdb?view=azure-cli-latest#az_cosmosdb_create)
* Content Source: [latest/docs-ref-autogen/cosmosdb.yml](https://github.com/MicrosoftDocs/azure-docs-cli/blob/master/latest/docs-ref-autogen/cosmosdb.yml)
* Service: **cosmos-db**
* GitHub Login: @rloutlaw
* Microsoft Alias: **routlaw**

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.