docs: docs for next release (#13621)

* docs: docs for next release

* changes to opentelemetry dependencies

* document plugin env variables

* document admin changes

* fix vale error

* add version notes

* document campaign budget updates

* document campaign changes in user guide

* document chages in cluster mode cli

* documented once promotion allocation

* document multiple API keys support

www/apps/user-guide/app/orders/payments/page.mdx

@@ -93,7 +93,13 @@ To capture an order’s payment:
 
 ## Refund Payment
 
-If you've made changes to an order, such as return or exchange items, that resulted in a negative outstanding amount, you can refund a previously-captured payment.
+You can refund a payment either partially or in full. This can be done for various reasons, such as when a customer returns an item or if there was an error in the order.
+
+<Note>
+
+Prior to [Medusa v2.11.0](https://github.com/medusajs/medusa/releases/tag/v2.11.0), you were only able to refund a payment after creating a return or making an order change. From Medusa v2.11.0 onwards, you can refund a payment directly from the order details page without needing to create a return or make an order change. If you're unable to refund a payment, contact your technical team to [update your Medusa application](!docs!/learn/update).
+
+</Note>
 
 Refunding the payment triggers its processing with the chosen payment provider, such as Stripe.
 
@@ -103,21 +109,21 @@ Refunding payments is irreversible.
 
 </Note>
 
-To refund an order’s negative outstanding amount:
+To refund an order's captured payment:
 
 1. Open the order's details page.
 2. Scroll to the Payment section.
 3. Click on the <InlineIcon Icon={EllipsisHorizontal} alt="three-dots" /> icon at the end of the payment to refund.
 4. Choose "Refund" from the dropdown.
 5. In the side window that opens, fill out the following fields:
-    - **Select payment to refund**: Choose the payment to refund an amount from.
     - **Amount**: Enter the amount to refund.
-    - **Note**: A note that the customer can see in the notification they receive.
+    - **Refund Reason**: Select a reason for the refund from the dropdown. You can [manage refund reasons in the settings](../../settings/refund-reasons/page.mdx).
+    - **Note**: Enter a note that the customer can see in the notification they receive.
 6. Once you’re done, click on the Save button.
 
 Once the payment is refunded, the customer will receive a notification about the refund and you can view the refund as part of the order's activity.
 
-![Refund Payment Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1739550855/User%20Guide/Screenshot_2025-02-14_at_6.34.01_PM_l9evmh.png)
+![Refund Payment Form](https://res.cloudinary.com/dza7lstvk/image/upload/v1759995110/User%20Guide/CleanShot_2025-10-09_at_10.31.35_2x_dvbdbp.png)
 
 ---
 

www/apps/user-guide/app/orders/returns/page.mdx

@@ -131,6 +131,6 @@ To cancel a requested return:
 
 ## Refund Customer for a Return
 
-If a return causes an outstanding amount, you can see it in the Summary section of an order. To learn how to refund the payment, refer to [this guide](../payments/page.mdx#refund-payment).
+If a return causes an outstanding amount, you can see it in the Summary section of an order. Refer to the [Manage Payments guide](../payments/page.mdx#refund-payment) to learn how to refund the customer for the return.
 
 ![Outstanding amount in summary](https://res.cloudinary.com/dza7lstvk/image/upload/v1739799808/User%20Guide/Screenshot_2025-02-17_at_3.42.49_PM_cjxgpg.png)