Updated flex discounts based on feedback.

src/pages/docs/flex-discounts/index.md

@@ -22,6 +22,17 @@ Key advantages of flexible discounts include:
   - Customers can review the reusable discount using the Preview Renewal API call.
   - Eliminates the need for customers to reapply a discount by using Update Subscription when it is already associated with an eligible subscription.
 
+  **How reusable and non-reusable discounts work:**
+
+  In general, promotions and discounts are available only between their configured start and end dates. Reusable discounts extend this model by allowing continued application beyond the original end date, subject to prior use and configuration.
+
+  | Aspect | Standard (Non-reusable) discount | Reusable discount |
+  |------|----------------------------------|------------------|
+  | Availability | Only between the discount start and end dates. | Between the start date and beyond the end date until the discount lock end date. |
+  | Renewal usage | Not allowed after the discount end date. | Allowed if the discount was used at least once before the end date. |
+  | Seat additions after end date | Not supported. | Supported until the discount lock end date. |
+  | Customer action required | Must opt in again with **Update Subscription** if applicable. | No additional opt-in required once applied. |
+
 ## Flexible discount types
 
 The following types of flexible discounts are available:

src/pages/docs/release-notes/index.md

@@ -24,6 +24,17 @@ The discount reusability allows eligible discounts to be reused beyond their ini
   - The newly introduced `REUSABLE` value of the `status` parameter indicates whether a flexible discount is reusable.
   - The `discountLockEndDate` parameter in the response indicates the date through which a flexible discount may continue to be applied beyond its initial offering period (start/end date). Reusable discounts are identified by the presence of the discountLockEndDate field in the response.
 
+**How reusable and non-reusable discounts work:**
+
+In general, promotions and discounts are available only between their configured start and end dates. Reusable discounts extend this model by allowing continued application beyond the original end date, subject to prior use and configuration.
+
+| Aspect | Standard (Non-reusable) discount | Reusable discount |
+|------|----------------------------------|------------------|
+| Availability | Only between the discount start and end dates. | Between the start date and beyond the end date until the discount lock end date. |
+| Renewal usage | Not allowed after the discount end date. | Allowed if the discount was used at least once before the end date. |
+| Seat additions after the end date | Not supported. | Supported until the discount lock end date .|
+| Customer action required | Must opt in again with **Update Subscription** if applicable. | No additional opt-in required once applied. |
+
 For more information, see [Manage Flexible Discounts](../flex-discounts/index.md).
 
 **Sandbox changes**

src/pages/docs/renewals/manual-renewals.md

@@ -56,7 +56,7 @@ Early renewal allows partners to renew subscriptions before the AD and introduce
 | Early renewal before AD (AD rolls over immediately) | AD = Nov 30, 2025\<br/\>Renewal Date = Nov 30, 2025\<br/\>Current quantity = 100 | Partner renews 100 seats on Nov 10, 2025                                | AD updates to Nov 30, 2026 \<br/\>Renewal Date stays Nov 30, 2025\<br/\>renewed_quantity = 100                | Auto‑renewal finds no remaining seats. \<br/\> \<br/\> AD changes. Renewal Date does not change.                                 |
 | Early renewal of partial quantities                 | AD = Oct 1, 2025\<br/\>Renewal Date = Oct 1, 2025\<br/\>Current quantity = 100   | Partner early‑renews 40 seats on Sep 10                                 | AD is updated to Oct 1, 2026\<br/\>renewed_quantity = 40                                                     | On Renewal Date, remaining 60 seats are auto‑renewed. \<br/\>\<br/\> Early renewal covers part; auto‑renewal completes the rest. |
 | Multiple early renewal orders                       | AD = Jan 31, 2026\<br/\>Renewal Date = Jan 31, 2026\<br/\>Current quantity = 200 | Jan 1: Renew 120 seats early\<br/\>Jan 5: Renew remaining 80 seats early | After first: AD is updated to Feb 1, 2027, renewed_quantity = 120\<br/\>After second: renewed_quantity = 200 | On Renewal Date, no remaining seats. \<br/\> \<br/\>AD rolls over only once, after the first early renewal.                      |
-| Return order after early renewal                    | Customer early renews 100 seats, AD rolls over.                                | Partner returns 20 seats                                                | renewed_quantity = 80\<br/\>AD does not roll back                                                            | On Renewal Date, system renews 20 remaining seats.\<br/\> \<br/\>Returns reduce renewed_quantity, not AD.                        |
+| Return order after early renewal                    | Customer early renews 100 seats, AD rolls over.                                | Partner returns 100 seats. \<br/\>**Note:** Partial returns are not supported for early renewal.                                                | renewed_quantity = 0\<br/\>AD does not roll back                                                            | On Renewal Date, system renews 100 remaining seats.                        |
 | Auto‑renewal without early renewal                  | AD = Apr 15, 2026\<br/\>Renewal Date = Apr 15, 2026\<br/\>renewal_quantity = 50  | No early renewal; auto‑renew runs on Renewal Date                       | System renews 50 seats                                                                                      | AD rolls to Apr 15, 2027. \<br/\>\<br/\> Auto‑renew always rolls AD when it completes.                                           |
 | Late renewal (after AD)                             | AD = July 10, 2026                                                             | Partner renews on July 20                                               | System processes renewal immediately                                                                        | AD rolls to July 10, 2027 as part of renewal completion                                                                        |
 | AD and Renewal Date divergence                      | AD = Dec 1, 2025\<br/\>Renewal Date = Dec 1, 2025                               | Early renewal on Nov 15, 2025                                           | AD is updated to Dec 1, 2026\<br/\>Renewal Date stays Dec 1, 2025                                            | Auto‑renew runs but finds everything renewed; next year dates align                                                            |