docs: add warning about Cosmos dB incompatibility (#13350)

Update the docs to warn about Cosmos dB incompatibility with payload,
<!--

Thank you for the PR! Please go through the checklist below and make
sure you've completed all the steps.

Please review the
[CONTRIBUTING.md](https://github.com/payloadcms/payload/blob/main/CONTRIBUTING.md)
document in this repository if you haven't already.

The following items will ensure that your PR is handled as smoothly as
possible:

- PR Title must follow conventional commits format. For example, `feat:
my new feature`, `fix(plugin-seo): my fix`.
- Minimal description explained as if explained to someone not
immediately familiar with the code.
- Provide before/after screenshots or code diffs if applicable.
- Link any related issues/discussions from GitHub or Discord.
- Add review comments if necessary to explain to the reviewer the logic
behind a change

### What?

### Why?

### How?

Fixes #

-->

---------

Co-authored-by: Paul Popus <paul@payloadcms.com>
Co-authored-by: Paul <paul@nouance.io>

Author: Braggedtooth

docs/production/deployment.mdx

@@ -82,8 +82,36 @@ unsupported `$facet` aggregation.
 
 ### CosmosDB
 
-When using Azure Cosmos DB, an index is needed for any field you may want to sort on. To add the sort index for all
-fields that may be sorted in the admin UI use the [indexSortableFields](/docs/configuration/overview) option.
+<Banner type="warning">
+While Azure Cosmos DB offers a MongoDB API it is not fully compatible due to strict and limited indexing behavior and many core features may not work reliably. For more details, see the [MongoDB driver's CosmosDB compatibility documentation](https://www.mongodb.com/docs/drivers/cosmosdb-support/#compatibility).
+</Banner>
+
+To improve compatibility, spread the `compatibilityOptions.cosmosdb` preset into your adapter. This applies all recommended settings at once:
+
+```ts
+import { mongooseAdapter, compatibilityOptions } from '@payloadcms/db-mongodb'
+
+export default buildConfig({
+  db: mongooseAdapter({
+    url: process.env.DATABASE_URL,
+    ...compatibilityOptions.cosmosdb,
+    indexSortableFields: true,
+  }),
+})
+```
+
+#### What `compatibilityOptions.cosmosdb` enables
+
+For advanced use cases, you can apply these options individually instead of spreading the preset:
+
+| Option                            | Value   | Purpose                                                                       |
+| --------------------------------- | ------- | ----------------------------------------------------------------------------- |
+| `bulkOperationsSingleTransaction` | `true`  | Processes bulk operations one at a time to avoid Cosmos DB transaction limits |
+| `transactionOptions`              | `false` | Disables multi-document transactions (unsupported by Cosmos DB)               |
+| `useJoinAggregations`             | `false` | Uses multiple find queries instead of correlated subqueries                   |
+| `usePipelineInSortLookup`         | `false` | Disables `$lookup` pipeline during sorting                                    |
+
+You can also add [`indexSortableFields`](/docs/configuration/overview) to index all sortable fields for the admin UI.
 
 ## File storage