IBX-8674: Improve product completeness and attribute definitions (#330)

* Improve product completeness and attribute definitions

---------

Co-authored-by: Adrien Dupuis <[email protected]>

Author: dabrt

docs/pim/create_product_types.md

@@ -23,8 +23,12 @@ Product code can have up to 64 characters. It can contain only letters, numbers,
 
 4\. Add fields that describe the product by dragging them from the **Field types** area to the **Field definitions** section, and then [configure them](../content_management/configure_ct_field_settings.md).
 
+For the information that is intended to be displayed, use [TextLine]([[= developer_doc =]]/content_management/field_types/field_type_reference/textlinefield/) fields for short text, and [RichText]([[= developer_doc =]]/content_management/field_types/field_type_reference/richtextfield/) fields for longer text that may require formatting.
+
 5\. Add attributes by dragging them or their groups from the **Library** area to the **Attributes** section.
 
+Use attributes to store precise lists of product properties or specifications.
+
 When you define attributes for the product type, you can add or remove either whole attribute groups or individual attributes.
 
 ![Adding attributes to a product type](img/adding_attributes.png "Adding attributes to a product type")
@@ -43,4 +47,3 @@ Attributes that have this option are used to [automatically generate product var
 !!! tip
 
     When your website supports multiple regions, you can use the search field to find the right one.
-

docs/pim/product_types.md

@@ -28,8 +28,10 @@ permission, you can [modify product types and add individual attributes or attri
 
 ### Attributes
 
-Attributes describe product characteristics.
-Customers can use them to filter and search for products.
+Unlike text fields that can be formatted and are intended to be displayed, product attributes precisely list product properties or specifications.
+
+Attributes serve as criteria for filtering and searching for products.
+They can also be used to define product variants.
 Attribute types define what kind of information you can store in an attribute.
 Typical product attribute examples include dimensions, weight, color, or format.
 

docs/pim/products.md

@@ -44,3 +44,8 @@ It lists all tasks required for product configuration, including:
 
 You can click the **Edit** button next to an unfinished task in the **Completeness** table to go directly to the screen where you can add the missing information.
 
+!!! note "Impact on availability"
+
+    Product completeness does not impact product availability or visibility on the storefront.
+    It is intended to help you ensure that product data is properly populated.
+    As long as your product meets the pricing and stock requirements, it can be published and made available for purchase regardless of its completeness score.

docs/pim/work_with_product_attributes.md

@@ -23,6 +23,12 @@ Available attribute types are:
 
 If the default list of attributes is not sufficient, ask your development team to [create a custom attribute type]([[= developer_doc =]]/pim/create_custom_attribute_type/).
 
+!!! note "Attribute translations"
+
+    Product attributes are not translatable.
+    Unlike text fields used in content, product attribute values cannot differ between languages.
+    Therefore, consider using attributes to store technical parameters and text fields for descriptive text intended to be displayed that may require translation.
+
 ## Create attribute groups
 
 Before you can proceed with creating attributes, you must first create at least one attribute group.