Read Many Documentation (#44159)

* change workloads based on feedback

* add staging yml file

* add staging yml file

* update readmany documentation

Author: tvaron3

sdk/cosmos/azure-cosmos/azure/cosmos/aio/_container.py

@@ -462,6 +462,7 @@ async def read_items(
         :keyword int throughput_bucket: The desired throughput bucket for the client
         :raises ~azure.cosmos.exceptions.CosmosHttpResponseError: The read-many operation failed.
         :returns: A CosmosList containing the retrieved items. Items that were not found are omitted from the list.
+            The returned items have no guaranteed ordering.
         :rtype: ~azure.cosmos.CosmosList
         """
 

sdk/cosmos/azure-cosmos/azure/cosmos/container.py

@@ -323,6 +323,7 @@ def read_items(
         :keyword int throughput_bucket: The desired throughput bucket for the client
         :raises ~azure.cosmos.exceptions.CosmosHttpResponseError: The read-many operation failed.
         :returns: A CosmosList containing the retrieved items. Items that were not found are omitted from the list.
+            The returned items have no guaranteed ordering.
         :rtype: ~azure.cosmos.CosmosList
         """