Language ans style review

Author: Yiyun333

content/en/docs/howto7/general/dev-best-practices.md

@@ -312,25 +312,28 @@ Complex processes and important business logic (like workflow processing or vali
 
 #### 4.2.6 Validating Inputs in Microflows
 
-When microflows are invoked from the client side, it is important to validate the inputs. By having validations, you prevent incorrect, inappropriate, or potentially harmful data from being used in your microflow's and can protect yourself against security vulnerabilities. The following best practices contribute to the integrity and validation of inputs in your microflows.
+When microflows are invoked from the client side, it is important to validate the inputs. By having validations, you prevent incorrect, inappropriate, or potentially harmful data from being used in your microflows. This protects your application against security vulnerabilities. The following presents the best practices regarding the integrity and validation of inputs in your microflows.
 
 ##### 4.2.6.1 Implementing Validation Checks
 
 Adding validation checks is vital for ensuring that input data conforms to the expected data type, format, range, or other application-specific constraints. For instance, if a numeric input is expected within a defined range, validation checks should confirm that the input is indeed numeric and falls within the specified range.
 
 ##### 4.2.6.2 Managing Unexpected Values
 
-When building microflows, it's important to account for the potential occurrence of unexpected values. These could be empty values, or values outside the expected range or format. This also includes ensuring read-only attributes only contain expected values.
+When building microflows, it is important to account for the potential occurrence of unexpected values. These could be empty values, or values outside the expected range or format. It is also important to ensure that read-only attributes only contain expected values.
 
-{{% alert color="warning" %}}
-We strongly recommend adding validation to all microflows inputs, including read-only attributes. We also recommend avoiding storing intermediary values in attributes (such as a “TotalPrice”), and instead calculate these when needed to ensure the correct value.
+{{% alert color="info" %}}
+We strongly recommend adding validation checks to all microflows inputs, including read-only attributes. 
+
+We also recommend avoiding storing intermediary values in attributes (such as, *TotalPrice*). Instead, calculate these values when needed to ensure you have the correct values.
 {{% /alert %}}
 
-Microflows should incorporate mechanisms to detect such anomalies, and respond suitably – this might involve returning an error message to the user or executing a fallback operation. 
+Microflows should incorporate mechanisms to detect unexpected values and respond suitably – this might involve returning an error message to the end-user or executing a fallback operation. 
+
+##### 4.2.6.3 Updating Validation Logic Regularly
 
-##### 4.6.2.3 Updating Validation Logic Regularly
+As the application evolves, the validation logic within microflows should be updated accordingly to reflect changes in business logic or data models. This regular review and update of validation checks ensures that microflows remain secure and function correctly over time.
 
-As the application evolves, the validation logic within microflows should be updated accordingly to reflect changes in business logic or data models. This regular review and update of validation checks will ensure that microflows remain secure and function correctly over time.
 By prioritizing the validation of inputs in microflows, you not only enhance the security of your application, but also ensure a more predictable and stable user experience. This practice underscores the development of reliable and robust applications.
 
 ### 4.3 Warnings and Modeler Feedback

content/en/docs/howto8/general/dev-best-practices.md

@@ -331,25 +331,28 @@ Complex processes and important business logic (like workflow processing or vali
 
 #### 4.2.6 Validating Inputs in Microflows
 
-When microflows are invoked from the client side, it is important to validate the inputs. By having validations, you prevent incorrect, inappropriate, or potentially harmful data from being used in your microflow's and can protect yourself against security vulnerabilities. The following best practices contribute to the integrity and validation of inputs in your microflows.
+When microflows are invoked from the client side, it is important to validate the inputs. By having validations, you prevent incorrect, inappropriate, or potentially harmful data from being used in your microflows. This protects your application against security vulnerabilities. The following presents the best practices regarding the integrity and validation of inputs in your microflows.
 
 ##### 4.2.6.1 Implementing Validation Checks
 
 Adding validation checks is vital for ensuring that input data conforms to the expected data type, format, range, or other application-specific constraints. For instance, if a numeric input is expected within a defined range, validation checks should confirm that the input is indeed numeric and falls within the specified range.
 
 ##### 4.2.6.2 Managing Unexpected Values
 
-When building microflows, it's important to account for the potential occurrence of unexpected values. These could be empty values, or values outside the expected range or format. This also includes ensuring read-only attributes only contain expected values.
+When building microflows, it is important to account for the potential occurrence of unexpected values. These could be empty values, or values outside the expected range or format. It is also important to ensure that read-only attributes only contain expected values.
 
-{{% alert color="warning" %}}
-We strongly recommend adding validation to all microflows inputs, including read-only attributes. We also recommend avoiding storing intermediary values in attributes (such as a “TotalPrice”), and instead calculate these when needed to ensure the correct value.
+{{% alert color="info" %}}
+We strongly recommend adding validation checks to all microflows inputs, including read-only attributes. 
+
+We also recommend avoiding storing intermediary values in attributes (such as, *TotalPrice*). Instead, calculate these values when needed to ensure you have the correct values.
 {{% /alert %}}
 
-Microflows should incorporate mechanisms to detect such anomalies, and respond suitably – this might involve returning an error message to the user or executing a fallback operation. 
+Microflows should incorporate mechanisms to detect unexpected values and respond suitably – this might involve returning an error message to the end-user or executing a fallback operation. 
+
+##### 4.2.6.3 Updating Validation Logic Regularly
 
-##### 4.6.2.3 Updating Validation Logic Regularly
+As the application evolves, the validation logic within microflows should be updated accordingly to reflect changes in business logic or data models. This regular review and update of validation checks ensures that microflows remain secure and function correctly over time.
 
-As the application evolves, the validation logic within microflows should be updated accordingly to reflect changes in business logic or data models. This regular review and update of validation checks will ensure that microflows remain secure and function correctly over time.
 By prioritizing the validation of inputs in microflows, you not only enhance the security of your application, but also ensure a more predictable and stable user experience. This practice underscores the development of reliable and robust applications.
 
 ### 4.3 Warnings and Studio Pro Feedback

content/en/docs/refguide/modeling/dev-best-practices.md

@@ -362,25 +362,28 @@ Complex processes and important business logic (like workflow processing or vali
 
 #### 4.2.6 Validating Inputs in Microflows
 
-When microflows are invoked from the client side, it is important to validate the inputs. By having validations, you prevent incorrect, inappropriate, or potentially harmful data from being used in your microflow's and can protect yourself against security vulnerabilities. The following best practices contribute to the integrity and validation of inputs in your microflows.
+When microflows are invoked from the client side, it is important to validate the inputs. By having validations, you prevent incorrect, inappropriate, or potentially harmful data from being used in your microflows. This protects your application against security vulnerabilities. The following presents the best practices regarding the integrity and validation of inputs in your microflows.
 
 ##### 4.2.6.1 Implementing Validation Checks
 
 Adding validation checks is vital for ensuring that input data conforms to the expected data type, format, range, or other application-specific constraints. For instance, if a numeric input is expected within a defined range, validation checks should confirm that the input is indeed numeric and falls within the specified range.
 
 ##### 4.2.6.2 Managing Unexpected Values
 
-When building microflows, it's important to account for the potential occurrence of unexpected values. These could be empty values, or values outside the expected range or format. This also includes ensuring read-only attributes only contain expected values.
+When building microflows, it is important to account for the potential occurrence of unexpected values. These could be empty values, or values outside the expected range or format. It is also important to ensure that read-only attributes only contain expected values.
 
-{{% alert color="warning" %}}
-We strongly recommend adding validation to all microflows inputs, including read-only attributes. We also recommend avoiding storing intermediary values in attributes (such as a “TotalPrice”), and instead calculate these when needed to ensure the correct value.
+{{% alert color="info" %}}
+We strongly recommend adding validation checks to all microflows inputs, including read-only attributes. 
+
+We also recommend avoiding storing intermediary values in attributes (such as, *TotalPrice*). Instead, calculate these values when needed to ensure you have the correct values.
 {{% /alert %}}
 
-Microflows should incorporate mechanisms to detect such anomalies, and respond suitably – this might involve returning an error message to the user or executing a fallback operation. 
+Microflows should incorporate mechanisms to detect unexpected values and respond suitably – this might involve returning an error message to the end-user or executing a fallback operation. 
+
+##### 4.2.6.3 Updating Validation Logic Regularly
 
-##### 4.6.2.3 Updating Validation Logic Regularly
+As the application evolves, the validation logic within microflows should be updated accordingly to reflect changes in business logic or data models. This regular review and update of validation checks ensures that microflows remain secure and function correctly over time.
 
-As the application evolves, the validation logic within microflows should be updated accordingly to reflect changes in business logic or data models. This regular review and update of validation checks will ensure that microflows remain secure and function correctly over time.
 By prioritizing the validation of inputs in microflows, you not only enhance the security of your application, but also ensure a more predictable and stable user experience. This practice underscores the development of reliable and robust applications.
 
 ### 4.3 Workflows

content/en/docs/refguide9/modeling/dev-best-practices.md

@@ -362,25 +362,28 @@ Complex processes and important business logic (like workflow processing or vali
 
 #### 4.2.6 Validating Inputs in Microflows
 
-When microflows are invoked from the client side, it is important to validate the inputs. By having validations, you prevent incorrect, inappropriate, or potentially harmful data from being used in your microflow's and can protect yourself against security vulnerabilities. The following best practices contribute to the integrity and validation of inputs in your microflows.
+When microflows are invoked from the client side, it is important to validate the inputs. By having validations, you prevent incorrect, inappropriate, or potentially harmful data from being used in your microflows. This protects your application against security vulnerabilities. The following presents the best practices regarding the integrity and validation of inputs in your microflows.
 
 ##### 4.2.6.1 Implementing Validation Checks
 
 Adding validation checks is vital for ensuring that input data conforms to the expected data type, format, range, or other application-specific constraints. For instance, if a numeric input is expected within a defined range, validation checks should confirm that the input is indeed numeric and falls within the specified range.
 
 ##### 4.2.6.2 Managing Unexpected Values
 
-When building microflows, it's important to account for the potential occurrence of unexpected values. These could be empty values, or values outside the expected range or format. This also includes ensuring read-only attributes only contain expected values.
+When building microflows, it is important to account for the potential occurrence of unexpected values. These could be empty values, or values outside the expected range or format. It is also important to ensure that read-only attributes only contain expected values.
 
-{{% alert color="warning" %}}
-We strongly recommend adding validation to all microflows inputs, including read-only attributes. We also recommend avoiding storing intermediary values in attributes (such as a “TotalPrice”), and instead calculate these when needed to ensure the correct value.
+{{% alert color="info" %}}
+We strongly recommend adding validation checks to all microflows inputs, including read-only attributes. 
+
+We also recommend avoiding storing intermediary values in attributes (such as, *TotalPrice*). Instead, calculate these values when needed to ensure you have the correct values.
 {{% /alert %}}
 
-Microflows should incorporate mechanisms to detect such anomalies, and respond suitably – this might involve returning an error message to the user or executing a fallback operation. 
+Microflows should incorporate mechanisms to detect unexpected values and respond suitably – this might involve returning an error message to the end-user or executing a fallback operation. 
+
+##### 4.2.6.3 Updating Validation Logic Regularly
 
-##### 4.6.2.3 Updating Validation Logic Regularly
+As the application evolves, the validation logic within microflows should be updated accordingly to reflect changes in business logic or data models. This regular review and update of validation checks ensures that microflows remain secure and function correctly over time.
 
-As the application evolves, the validation logic within microflows should be updated accordingly to reflect changes in business logic or data models. This regular review and update of validation checks will ensure that microflows remain secure and function correctly over time.
 By prioritizing the validation of inputs in microflows, you not only enhance the security of your application, but also ensure a more predictable and stable user experience. This practice underscores the development of reliable and robust applications.
 
 ### 4.3 Workflows