incorporate feedback

fivetran · Oct 11, 2024 · 317caf0 · 317caf0
1 parent d5cb67a
commit 317caf0
Show file tree

Hide file tree

Showing 6 changed files with 24 additions and 44 deletions.
diff --git a/README.md b/README.md
@@ -29,7 +29,7 @@ The following table provides a detailed list of all tables materialized within t
 | [marketo__campaigns](https://fivetran.github.io/dbt_marketo/#!/model/model.marketo.marketo__campaigns)       | Each record represents a Marketo campaign, enriched with metrics about email performance.                                                      |
 | [marketo__email_sends](https://fivetran.github.io/dbt_marketo/#!/model/model.marketo.marketo__email_sends)     | Each record represents the send of a Marketo email, enriched with metrics about email performance.                                                   |
 | [marketo__email_templates](https://fivetran.github.io/dbt_marketo/#!/model/model.marketo.marketo__email_templates) | Each record represents a Marketo email template, enriched with metrics about email performance.                                                |
-| [marketo__lead_history](https://fivetran.github.io/dbt_marketo/#!/model/model.marketo.marketo__lead_history)    | Each record represents the state of a lead on a specific day. The columns in this model are specified with the `lead_history_columns` variable. The start date is configured by the `marketo__first_date` variable, which by default, for dbt Core™ users, is the date of the earliest lead record, and for Fivetran Quickstart Data Model users, is 18 months in the past. |
+| [marketo__lead_history](https://fivetran.github.io/dbt_marketo/#!/model/model.marketo.marketo__lead_history)    | Each record represents the state of a lead on a specific day. The columns in this model are specified with the `lead_history_columns` variable. The start date is configured by the `marketo__first_date` variable, which by default, for dbt Core™ users, is the date of the earliest lead record, and for Fivetran Quickstart Data Model users, is 18 months in the past. There is currently no way to adjust this within the Quickstart environment, though incremental model runs will slowly look further and further in the past. However, please be aware that a full refresh will reset the clock and limit data to 18 months prior. |
 | [marketo__leads](https://fivetran.github.io/dbt_marketo/#!/model/model.marketo.marketo__leads)           | Each record represents a Marketo lead, enriched with metrics about email performance.                                                          |
 | [marketo__programs](https://fivetran.github.io/dbt_marketo/#!/model/model.marketo.marketo__programs)         | Each record represents a Marketo program, enriched with metrics about email performance.                                                       |
 
@@ -137,7 +137,7 @@ models:
       marketo__first_date: "yyyy-mm-dd" 
 ```
 
-> For Fivetran Quickstart Data Model users, the package will look 18 months in the past. There is currently no way to adjust this within the Quickstart environment, though incremental runs will slowly look further and further in the past. A full refresh will reset the clock and limit data to 18 months prior. 
+> For Fivetran Quickstart Data Model users, the package will look 18 months in the past. There is currently no way to adjust this within the Quickstart environment, though incremental runs will slowly look further and further in the past. However, please be aware that a full refresh will reset the clock and limit data to 18 months prior.
 
 </details>
 

diff --git a/docs/catalog.json b/docs/catalog.json
diff --git a/docs/index.html b/docs/index.html
diff --git a/docs/manifest.json b/docs/manifest.json
diff --git a/docs/run_results.json b/docs/run_results.json
diff --git a/models/marketo.yml b/models/marketo.yml
@@ -269,7 +269,12 @@ models:
         description: '{{ doc("count_unique_clicks") }}'
 
   - name: marketo__lead_history
-    description: Each record is what a Marketo lead looked like on each day.
+    description: >
+      Each record is what a Marketo lead looked like on each day. The columns in this model are specified with the `lead_history_columns` variable. 
+      
+      The start date is configured by the `marketo__first_date` variable, which by default, for dbt Core™ users, is the date of the earliest lead record.
+      For Fivetran Quickstart Data Model users, `marketo__first_date` is 18 months in the past. There is currently no way to adjust this within the Quickstart environment, 
+      though incremental model runs will slowly look further and further in the past. However, please be aware that a full refresh will reset the clock and limit data to 18 months prior.
     columns:
       - name: lead_history_id
         description: Surrogate key combining date_day and lead_id.
@@ -283,7 +288,10 @@ models:
           - not_null
 
       - name: date_day
-        description: The date of the lead was observed in this state.
+        description: >
+          The date of the lead was observed in this state. For dbt Core™ users, the default earliest `date_day` will be the date of the earliest lead record. This can be adjusted via the `marketo__first_date` variable.
+          For Fivetran Quickstart Data Model users, `marketo__first_date` is 18 months in the past. There is currently no way to adjust this within the Quickstart environment,
+          though incremental model runs will slowly look further and further in the past. However, please be aware that a full refresh will reset the clock and limit data to 18 months prior.
 
   - name: marketo__leads
     description: Each record is a Marketo lead.