[IMP] Sales: adding/deleting variants clarification

Author: theRealThagomizer

content/applications/sales/sales/products_prices/products/variants.rst

@@ -300,5 +300,34 @@ impacts that can be taken advantage of throughout the Odoo database.
 .. note::
    Changes to the product template automatically apply to every variant of that product.
 
+Adding and deleting attributes from product variants
+====================================================
+
+When attributes are added or deleted from products, variants that have already been created are
+affected. Depending on whether or not these variants have been used in orders, they are archived or
+deleted and recreated.
+
+- Variants that have not been used in an order are deleted and recreated with the new attributes.
+  This may result in the deletion of additional customizations, depending on how the variants were
+  configured.
+- Variants that have been previously used in one or more orders are archived and removed from the
+  product catalog instead of being deleted.
+
+.. example::
+   A business offers leather jackets with a variety of customization options: size, color, and
+   material. They sell standard leather jackets and limited edition leather jackets as two different
+   products. The standard leather jackets are a best-selling item, but the limited edition jackets
+   have not sold yet. Due to rising costs, the business makes the decision to stop offering
+   different materials and removes the corresponding attribute from the product variants.
+
+   Because the limited edition jackets have not been used in any sales orders, all variants that
+   include the material attribute are deleted and the variants are automatically recreated without
+   the attribute. Additionally, any customizations will be lost when the variants are deleted.
+
+   Since the standard leather jackets have been used in sales orders, the variants with the material
+   attribute are archived instead and can be found by navigating to :menuselection:`Sales app -->
+   Products --> Product Variants`, clicking the drop-down in the search bar, and finally clicking
+   the :guilabel:`Archived filter`.
+
 .. seealso::
    :doc:`import`