updated README with CX suggestions

Author: Mingxihuang954

ConstraintModels/ExampleCMLRuleSets/README.md

@@ -6,32 +6,37 @@ This section describes in plain English the business rules that are implemented
 
 For the Auto Silver rule examples, assume the following constraints:
 
-1. For the Auto Silver bundle, if the most expensive vehicle is worth over $50,000 and the oldest vehicle's model year is before 2020, the bundle must have a Medical Payment coverage with $2000 limit.
-2. For a Vehicle bundle, vehicles newer than 2023 must have Collision coverage with $5000 limit.
-3. For a Vehicle bundle, vehicles older than 2020 with Collision coverage selected with $200 deductible, the vehicle bundle must NOT have Uninsured Motorist coverage.
-4. For a driver, Driver Age and First Licensed Age must be greater than 16.
-5. For the Auto Silver bundle, if at least one vehicle doesn't have Anti-Theft, at least one driver has accident points greater than 5, and item price for product is over $100: Must have Bodily Injury & Property Damage Coverag; Property damage per Accident Limit of BIPD must be hidden; $2000 of Bodily Injury Per Accident Limit of BIPD must be hidden.
-6. For the Auto Silver bundle, if the quote has medical payments covered with a limit of $1000, and the current user is a standard user, the quote must have BIPD with a bodily injury per person limit of $1000
+-  For the Auto Silver bundle, if the most expensive vehicle is worth over $50,000 and the oldest vehicle's model year is before 2020, the bundle must have a Medical Payment coverage with $2000 limit.
+- For a Vehicle bundle, vehicles newer than 2023 must have Collision coverage with $5000 limit.
+- For a Vehicle bundle, vehicles older than 2020 with Collision coverage selected with $200 deductible, the vehicle bundle must not have Uninsured Motorist coverage.
+-  For a driver, Driver Age and First Licensed Age must be greater than 16.
+-  For the Auto Silver bundle, if at least one vehicle doesn't have Anti-Theft, at least one driver has accident points greater than 5, and item price for product is over $100: Must have Bodily Injury & Property Damage Coverage; Property damage per Accident Limit of BIPD must be hidden; $2000 of Bodily Injury Per Accident Limit of BIPD must be hidden.
+-  For the Auto Silver bundle, if the quote has medical payments covered with a limit of $1000, and the current user is a standard user, the quote must have BIPD with a bodily injury per person limit of $1000
 
 
 ### Family Health Insurance Comprehensive (Medical) Sample Constraints
 
 For the Family Health Insurance Comprehensive rule examples, assume the following constraints:
 
-1. For a primary member, if the primary member has Out-Patient coverage, and the primary member is a male over 40 years old or is married, the policy must have Preventive Care and Wellness coverage with Deductible Limit of $5000, and must have Chronic Disease coverage.
-2. For a primary member, if the current user is a system administrator, and the primary member is female with at least one single dependent member: exclude Critical Illness Surgery for primary member and hide attribute Out Network Copay for primary member's Out-Patient coverage; For a dependent member, hide attribute value Others for Gender and add Critical Illness Surgery coverage.
-3. For a dependent member, if a dependent member is younger than 30, and the primary member's Preventive Care and Wellness has Out Network Deductible Limit is greater than or equal to $250, the dependent member must have Preventive Care and Wellness with Annual out of pocket limit of $20,000.
-4. If the primary member has Out-Patient coverage and the current user profile is a system administrator, the dependent member must have Chronic Disease coverage, and the primary member's Out-Patient coverage must have Doctor visit copay of $10,000.
-5. For a primary member, if the primary member's age is greater than 40 and the oldest dependent member's age is less than 30, the primary member must have Chronic Disease coverage; For a dependent member, if its primary member's age is greater than 40 and its age is less than 30 must have Out Patient coverage.
+- For a primary member, if the primary member has Outpatient coverage, and the primary member is a male over 40 years old or is married, the policy must have Preventive Care and Wellness coverage with Deductible Limit of $5000, and must have Chronic Disease coverage.
+- If the current user is a system administrator, and the primary member is female with at least one single dependent member: For the primary member, exclude Critical Illness Surgery and hide attribute Out Network Copay for Outpatient coverage; For a dependent member, hide the attribute value Others for the Gender field and add Critical Illness Surgery coverage.
+- If a dependent member is younger than 30, and the primary member's Preventive Care and Wellness has Out Network Deductible Limit is greater than or equal to $250, the dependent member must have Preventive Care and Wellness with Annual out of pocket limit of $20,000.
+- If the primary member has Outpatient coverage and the current user profile is a system administrator, the dependent member must have Chronic Disease coverage, and the primary member's Outpatient coverage must have Doctor visit copay of $10,000.
+- If the primary member's age is greater than 40:
+    - any dependents under 30 must have Outpatient coverage;
+    - if the oldest dependent member's age is less than 30, the primary member must have Chronic Disease coverage.
 
 
 ### Commercial Property Insurance( Commercial) Sample Constraints
 
 For the Commercial Property Insurance rule examples, assume the following constraints:
 
-1. For a Commercial Property Insurance bundle, If Commercial General Liability coverage is selected, and no location States is TX (Texas), and the aggregated total Commercial Building Burglary coverage Limits are less than $50,000, and the aggregated total Warehouse Building Burglary coverage is less than $20,000, and the sum of Equipment Value of that Commercial Building is greater than $100,000, then set Commercial General Liability coverage Limit to $50,000.
-2. For an Equipment bundle, if Commercial General Liability coverage Limit is less than $2,000,000, and location State is not NY (New York), and Building Burglary coverage Limit is less than $50,000, and General Equipment Value is greater than $100,000, then add General Equipment coverage to General Equipment bundle and set General Equipment coverage Limit to $50,000.
-3. For an Equipment bundle, if Equipment is in 'Good' Condition, and UserProfile is system administrator, and building Age is 6, and location State is NY, then exclude Equipment coverage of the Equipment.
-4. For a location bundle, if City is Boston, State needs to be MA; if City is San Francisco, State needs to be CA.
-5. For a Commercial Property Insurance bundle, if Agreed Value of Commercial Property Insurance is greater than $10,000, hide SIC code attribute.
-6. For a Commercial Property Insurance bundle, if at least one equipment's Condition is Good, and at least one building Age is 6, add General Liability coverage. For Building bundle, if at least one equipment's Condition is Good and its Age is 6, hide its attribute Sprinklers; For a Equipment bundle, hide Attribute Value 'New' for Equipment Condition.
+- For a Commercial Property Insurance bundle, If the aggregated total Commercial Building Burglary coverage Limits is $50,000, and the aggregated total Warehouse Building Burglary coverage is $50,000, then add Commercial General Liability coverage and set Limit to $50,000.
+- For an Equipment bundle, if Commercial General Liability coverage Limit is less than $2,000,000, and if the business has no locations in New York, and Building Burglary coverage Limit is less than $50,000, and General Equipment Value is greater than $100,000, then add General Equipment coverage to General Equipment bundle and set General Equipment coverage Limit to $50,000.
+- For an Equipment bundle, if Equipment is in 'Good' Condition, and UserProfile is system administrator, and building Age is greater than 6, and location is NY, then exclude Equipment coverage of the Equipment.
+- For a location bundle, if City is Boston, State must be MA; if City is San Francisco, State must be CA.
+- For a Commercial Property Insurance bundle, if Agreed Value of Commercial Property Insurance is greater than $10,000, hide SIC code attribute.
+- For a Commercial Property Insurance bundle, if at least one equipment's Condition is Good, and at least one building Age is 6:
+    - add General Liability coverage. 
+    - For a Building bundle, if at least one equipment's Condition is Good and its Age is 6, hide its attribute Sprinklers; 
+    - For a Equipment bundle, hide Attribute Value 'New' for Equipment Condition.

ConstraintModels/MigrationTools/README.md

@@ -14,7 +14,7 @@ Before using these tools:
   - Constraint Rule Engine enabled in target orgs (for CML migrations)
   - Appropriate API access and authentication credentials
 
-<!-- Here, you could put a little info like what needs to be ready in the org before using the tools. For example, relevant Context Definition and PCM data. -->
+Before using the CML Migration Tool, make sure the target org already has relevant Context Definition and PCM data such as Attributes, Product Classifications, Products, and Product Related Components.
 
 ---
 
@@ -25,11 +25,10 @@ Before using these tools:
 The **CML Migration Tool** enables seamless import, export, and deployment of Constraint Modeling Language (CML) rule sets across Salesforce orgs:
 
 - Moving rule sets from sandbox to production environments
-- Updating of the existing rule sets
+- Updating the existing rule sets
 - Creating backups of your CML configurations
 - Sharing rule set templates across multiple orgs
 
-Before using the CML Migration Tool, make sure the target org already has relevant Context Definition and PCM data such as Attributes, Product Classifications, Products, and Product Related Components.
 
 #### How to Use the CML Migration Tool
 
@@ -83,7 +82,7 @@ The **Multi Cloud Data Migrator** is a comprehensive tool for migrating Insuranc
 
 #### SObject Keys Reference
 
-For Step 7, it's critical to ensure your data is clean and properly prepared.
+For a successful migration, it's critical to ensure your data is clean and properly prepared.
 
 - Check Your Keys: Use the **View Plan** button to review the migration strategy.
 - Ensure Uniqueness: Verify that all Key fields and composite key combinations are populated and unique in the source data.

ConstraintModels/ProductModels/README.md

@@ -1,4 +1,6 @@
-<!-- For these hierarchies it would be nice to have a paragraph at the beginning of the README that says how these can be used. I assume it's not possible to cut and paste or import these into an org. Are these provided just to show what they look like? Is the user expected to recreate them manually? Are there JSON versions of these that can be imported somehow? -->
+## Product Model Hierarchies
+
+The following product hierarchies are provided to help you visualize and quickly understand the product structures that the constraint models are built upon. These diagrams illustrate the relationships between root products, child products, coverages, and classifications, making it easier to comprehend how the CML rules apply across different levels of the insurance product hierarchy. Use these as reference when working with the corresponding constraint model examples.
 
 ### Auto Silver