Inconsistency

[DavidKlempfner]

"Do not use ToList() on DocumentClient.CreateDocumentQuery(...) which uses blocking calls to synchronously drain the query. Use AsDocumentQuery() to drain the query asynchronously." This is under a list of items titled "Do not". The other items don't start with "Do not" so this last one is inconsistent and reads strangely if you read the title of the list first. I think this should be rewritten to: "Use ToList() on DocumentClient.CreateDocumentQuery(...). This uses blocking calls to synchronously drain the query. Use AsDocumentQuery() to drain the query asynchronously instead."

---

Document Details

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

• ID: 19819758-be79-2347-d1d9-7c950d8513ae
• Version Independent ID: 8099f2c8-f8bc-6459-c6fe-6b65b02fc6a2
• Content: Azure Cosmos DB performance tips for .NET SDK v2
• Content Source: articles/cosmos-db/nosql/performance-tips.md
• Service: cosmos-db
• Sub-service: nosql
• GitHub Login: @StefArroyo
• Microsoft Alias: esarroyo

[SaibabaBalapur-MSFT]

@DavidKlempfner Thanks for your feedback! We will investigate and update as appropriate.

[shaktisingh-msft]

Hi @StefArroyo,

Could you please look into this document update request. Thanks.

[seesharprun]

Hello @DavidKlempfner,

We have updated the language of this item in the list to better fit the other items.

The change should be live later today.