This branch was auto-updated!

website/docs/docs/build/dimensions.md

@@ -252,7 +252,8 @@ This example shows how to create slowly changing dimensions (SCD) using a semant
 | 333             | 2    | 2020-08-19 | 2021-10-22| 
 | 333             | 3    | 2021-10-22 | 2048-01-01|  
 
-Take note of the extra arguments under `validity_params`: `is_start` and `is_end`. These arguments indicate the columns in the SCD table that contain the start and end dates for each tier (or beginning or ending timestamp column for a dimensional value).
+
+The `validity_params` include two important arguments — `is_start` and `is_end`. These specify the columns in the SCD table that mark the start and end dates (or timestamps) for each tier or dimension. Additionally, the entity is tagged as `natural` to differentiate it from a `primary` entity. In a `primary` entity, each entity value has one row. In contrast, a `natural` entity has one row for each combination of entity value and its validity period.
 
 ```yaml 
 semantic_models:
@@ -280,9 +281,11 @@ semantic_models:
       - name: tier
         type: categorical
 
+    primary_entity: sales_person
+
     entities:
       - name: sales_person
-        type: primary 
+        type: natural 
         expr: sales_person_id
 ```