Merge branch 'DEVDOCS-6056-tax-incl' of https://github.com/bigcommerce/docs into DEVDOCS-6056-tax-incl

Author: bc-andreadao

.github/CODEOWNERS

@@ -6,3 +6,12 @@
 # be identified in the format @org/team-name. Teams must have
 # explicit write access to the repository. In this example,
 # the octocats team in the octo-org organization owns all .md files.
+
+# @bigcommerce/team-catalog-ops
+reference/catalog @bigcommerce/team-catalog-ops
+archive/rest-catalog @bigcommerce/team-catalog-ops
+
+# @bigcommerce/team-multi-storefront
+docs/storefront/multi-storefront @bigcommerce/team-multi-storefront
+reference/channels.v3.yml @bigcommerce/team-multi-storefront
+reference/sites.v3.yml @bigcommerce/team-multi-storefront

reference/catalog/categories_catalog.v3.yml

@@ -262,7 +262,7 @@ paths:
                 description:
                   type: string
                   description: |
-                    The product description, which can include HTML formatting.
+                    The category description, which can include HTML formatting.
                   example: <p>We offer a wide variety of products perfect for relaxing</p>
                 views:
                   type: integer

reference/orders.v2.oas2.yml

@@ -3918,10 +3918,6 @@ components:
           description: Override value for the total, including tax. If specified, the field `total_ex_tax` is also required. The value can't be negative. (Float, Float-As-String, Integer)
           example: '225.0000'
           type: string
-        is_tax_inclusive_pricing:
-          description: Indicates whether the order total is inclusive of tax.
-          example: false
-          type: boolean
         wrapping_cost_ex_tax:
           description: The value of the wrapping cost, excluding tax. The value can't be negative. (Float, Float-As-String, Integer)
           example: '0.0000'
@@ -4137,7 +4133,12 @@ components:
           example: false
           type: boolean
         is_tax_inclusive_pricing:
-          description: Indicates whether the order total is inclusive of tax.
+          description: |-
+            Indicate whether the order's base prices include tax.
+
+            If true, the base prices are inclusive of tax, and the values of `subtotal_inc_tax`, `shipping_cost_inc_tax`, `handling_cost_inc_tax`, `wrapping_cost_inc_tax` and `total_inc_tax` are not estimated but actual values and can be reliable for accounting purposes.
+
+            If false, the base prices are exclusive of tax, and the values of `subtotal_ex_tax`, `shipping_cost_ex_tax`, `handling_cost_ex_tax`, `wrapping_cost_ex_tax` and `total_ex_tax` are not estimated but actual values and can be reliable for accounting purposes.
           example: false
           type: boolean
         is_email_opt_in: