Small fixes - Documentation and comments

sdk/cosmos/azure-cosmos/README.md

@@ -83,7 +83,9 @@ For more information about these resources, see [Working with Azure Cosmos datab
 
 ## Limitations
 
-As of August 2020 the features below are **not supported**.
+Currently the features below are **not supported**.
+
+**Data Plane Limitations:**
 
 * Group By queries (in roadmap for 2021)
 * Language Native async i/o (in roadmap for 2021)
@@ -96,19 +98,28 @@ As of August 2020 the features below are **not supported**.
 * Change Feed: Read specific time 
 * Change Feed: Read from the beggining
 * Change Feed: Pull model
+* Cross-partition ORDER BY for mixed types
+
+**Control Plane Limitations:**
+
 * Get CollectionSizeUsage, DatabaseUsage, and DocumentUsage metrics
 * Create User
 * Create Geospatial Index
 * Provision Autoscale DBs or containers
-* Cross-partition ORDER BY for mixed types
+* Update Autoscale throughput
 * Update analytical store ttl (time to live)
 * Get the connection string
-* Get the minimum RU/s of a container. For more information, click [here](https://docs.microsoft.com/azure/cosmos-db/concepts-limits#minimum-throughput-limits) or use [Azure CLI](https://docs.microsoft.com/azure/cosmos-db/scripts/cli/sql/throughput#sample-script) examples for Cosmos DB.
+* Get the minimum RU/s of a container. 
 
-## Bulk processing limitation workaround
+## Bulk processing Limitation Workaround
 
 If you want to use Python SDK to perform bulk inserts to Cosmos DB, the best alternative is to use [stored procedures](https://docs.microsoft.com/azure/cosmos-db/how-to-write-stored-procedures-triggers-udfs) to write multiple items with the same partition key.
 
+## Control Plane Limitations Workaround
+
+Typically you can use [Azure Portal](https://portal.azure.com/), [Azure CLI](https://docs.microsoft.com/azure/cosmos-db/manage-with-cli) or [PowerShell](https://docs.microsoft.com/azure/cosmos-db/manage-with-powershell) for the control plane unsupported limitations.
+
+
 ## Boolean Data Type
 
 While the Python language [uses](https://docs.python.org/3/library/stdtypes.html?highlight=boolean#truth-value-testing) "True" and "False" for boolean types, Cosmos DB [accepts](https://docs.microsoft.com/azure/cosmos-db/sql-query-is-bool) "true" and "false" only. In other words, the Python language uses Boolean values with the first uppercase letter and all other lowercase letters, while Cosmos DB and its SQL language use only lowercase letters for those same Boolean values. How to deal with this challenge?

sdk/cosmos/azure-cosmos/azure/cosmos/cosmos_client.py

@@ -128,7 +128,7 @@ class CosmosClient(object):
     :type credential: str or dict[str, str]
     :param str consistency_level: Consistency level to use for the session. The default value is "Session".
     :keyword int timeout: An absolute timeout in seconds, for the combined HTTP request and response processing.
-    :keyword int request_timeout: The HTTP request timeout in seconds.
+    :keyword int request_timeout: The HTTP request timeout in milliseconds.
     :keyword str connection_mode: The connection mode for the client - currently only supports 'Gateway'.
     :keyword proxy_config: Connection proxy configuration.
     :paramtype proxy_config: ~azure.cosmos.ProxyConfiguration