[IMP] Sales: adding/deleting variants clarification

Author: theRealThagomizer

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

@@ -92,8 +92,8 @@ once an attribute is added to a product.
    order for the :guilabel:`Multi-checkbox (option)` to work properly as the :guilabel:`Display
    Type`.
 
-- :guilabel:`Instantly`: creates all possible variants as soon as attributes and values are added
-  to a product template.
+- :guilabel:`Instantly`: creates all possible variants as soon as attributes and values are added to
+   a product template.
 - :guilabel:`Dynamically`: creates variants **only** when corresponding attributes and values are
   added to a sales order.
 - :guilabel:`Never (option)`: never automatically creates variants.
@@ -162,23 +162,23 @@ color selector pop-up window.
 .. image:: variants/picking-a-color.png
    :alt: Selecting a color from the HTML color pop-up window that appears on attribute form.
 
-In this pop-up window, select a specific color by dragging the color slider to a particular hue,
-and clicking on the color portion directly on the color gradient window.
+In this pop-up window, select a specific color by dragging the color slider to a particular hue, and
+clicking on the color portion directly on the color gradient window.
 
 Or, choose a specific color by clicking the *dropper* icon, and selecting a desired color that's
 currently clickable on the screen.
 
-If you sell products with specific patterns, you can also add an image to display the
-pattern of the product. To do so, click the :icon:`fa-camera` :guilabel:`(camera)` icon,
-then click the :icon:`fa-pencil` :guilabel:`(pencil)` icon and select an image from your local
-drive. This pattern will appear as a color option on the ecommerce product page.
+If you sell products with specific patterns, you can also add an image to display the pattern of the
+product. To do so, click the :icon:`fa-camera` :guilabel:`(camera)` icon, then click the
+:icon:`fa-pencil` :guilabel:`(pencil)` icon and select an image from your local drive. This pattern
+will appear as a color option on the ecommerce product page.
 
 .. image:: variants/ecommerce-pattern-option.png
    :alt: Pattern as color option on the ecommerce page.
 
 .. tip::
-   Attributes can also be created directly from the product template by adding a new line and
-   typing the name into the :guilabel:`Variants` tab.
+   Attributes can also be created directly from the product template by adding a new line and typing
+   the name into the :guilabel:`Variants` tab.
 
 Once an attribute is added to a product, that product is listed and accessible, via the attribute's
 :guilabel:`Related Products` smart button. That button lists every product in the database currently
@@ -283,8 +283,8 @@ impacts that can be taken advantage of throughout the Odoo database.
 
 - :guilabel:`Barcode`: barcodes are associated with each variant, instead of the product template.
   Each individual variant can have its own unique barcode/SKU.
-- :guilabel:`Price`: every product variant has its own public price, which is the sum of the
-  product template price *and* any extra charges for particular attributes.
+- :guilabel:`Price`: every product variant has its own public price, which is the sum of the product
+  template price *and* any extra charges for particular attributes.
 
   .. example::
    A red shirt's sales price is $23 -- because the shirt's template price is $20, plus an additional
@@ -299,5 +299,18 @@ 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.
+
 .. seealso::
    :doc:`import`