add callout for net new snapshots

website/docs/reference/snapshot-configs.md

@@ -7,21 +7,18 @@
 
 import ConfigResource from '/snippets/_config-description-resource.md';
 import ConfigGeneral from '/snippets/_config-description-general.md';
+import SnapshotsYamlConfig from '/snippets/_snapshots-yaml-config.md';
 
 
 ## Related documentation
 * [Snapshots](/docs/build/snapshots)
 * The `dbt snapshot` [command](/reference/commands/snapshot)
 
-<!--
-Parts of a snapshot:
-- name
-- query
--->
 
 ## Available configurations
 ### Snapshot-specific configurations
 
+
 <ConfigResource meta={frontMatter.meta} />
 
 <VersionBlock lastVersion="1.8">
@@ -78,8 +75,9 @@
     [+](/reference/resource-configs/plus-prefix)[strategy](/reference/resource-configs/strategy): timestamp | check
     [+](/reference/resource-configs/plus-prefix)[updated_at](/reference/resource-configs/updated_at): <column_name>
     [+](/reference/resource-configs/plus-prefix)[check_cols](/reference/resource-configs/check_cols): [<column_name>] | all
+    [+](/reference/resource-configs/plus-prefix)[invalidate_hard_deletes](/reference/resource-configs/invalidate_hard_deletes) : true | false    
     [+](/reference/resource-configs/plus-prefix)[snapshot_meta_column_names](/reference/resource-configs/snapshot_meta_column_names): {<dictionary>}
-    [+](/reference/resource-configs/plus-prefix)[invalidate_hard_deletes](/reference/resource-configs/invalidate_hard_deletes) : true | false
+    [+](/reference/resource-configs/plus-prefix)[dbt_valid_to_current](/reference/resource-configs/dbt_valid_to_current): <string> 
 ```
 
 </File>
@@ -112,8 +110,9 @@
       [strategy](/reference/resource-configs/strategy): timestamp | check
       [updated_at](/reference/resource-configs/updated_at): <column_name>
       [check_cols](/reference/resource-configs/check_cols): [<column_name>] | all
-      [snapshot_meta_column_names](/reference/resource-configs/snapshot_meta_column_names): {<dictionary>}
       [invalidate_hard_deletes](/reference/resource-configs/invalidate_hard_deletes) : true | false
+      [snapshot_meta_column_names](/reference/resource-configs/snapshot_meta_column_names): {<dictionary>}
+      [dbt_valid_to_current](/reference/resource-configs/dbt_valid_to_current): <string>
 ```
 </File>
 
@@ -125,7 +124,8 @@
 
 <VersionBlock firstVersion="1.9">
 
-Configurations can be applied to snapshots using the [YAML syntax](/docs/build/snapshots), available in Versionless and dbt v1.9 and higher, in the `snapshot` directory file.
+<SnapshotsYamlConfig />
+
 
 </VersionBlock>
 
@@ -150,11 +150,27 @@
 
 </Tabs>
 
+### Snapshot configuration migration
+
+The latest snapshot YAML configurations introduced in dbt v1.9 and higher (such as [`snapshot_meta_column_names`](/reference/resource-configs/snapshot_meta_column_names) and [`dbt_valid_to_current`](/reference/resource-configs/dbt_valid_to_current)) are best suited for new snapshots. For existing snapshots, we recommend the following to avoid any inconsistencies to your snapshots:
+
+#### For new snapshots
+- Use the latest snapshot YAML configurations when creating new snapshots that didn't exist previously.
+
+#### For existing snapshots
+- Migrate tables &mdash; Migrate the previous snapshot to the new table schema and values:
+  - Create a backup copy of your snapshots.
+  - Use `alter` statements as needed to ensure table consistency or use a script to apply the `alter` statements.
+- New YAML config &mdash; Convert the YAML configurations one at a time, testing as you go. 
+
+If you use one of the latest configs, such as `dbt_valid_to_current`, without migrating your data may result in mixed old and new data, leading to incorrect downstream result.
+
 
 ### General configurations
 
 <ConfigGeneral />
 
+
 <Tabs
   groupId="config-languages"
   defaultValue="project-yaml"
@@ -170,6 +186,7 @@
 
 <VersionBlock firstVersion="1.9">
 
+
 ```yaml
 snapshots:
   [<resource-path>](/reference/resource-configs/resource-path):
@@ -256,7 +273,7 @@
 
 <VersionBlock firstVersion="1.9">
 
-Configurations can be applied to snapshots using [YAML syntax](/docs/build/snapshots), available in Versionless and dbt v1.9 and higher, in the `snapshot` directory file.
+<SnapshotsYamlConfig />
 
 </VersionBlock>
 

website/snippets/_snapshots-yaml-config.md

@@ -0,0 +1 @@
+Define snapshots using the latest [YAML configurations](/docs/build/snapshots#configuring-snapshots), available in Versionless and dbt v1.9 and higher, in the `snapshot` directory file.

website/src/components/expandable/styles.module.css

@@ -145,4 +145,5 @@
 .headerText {
   display: flex;
   align-items: center;
-}
+}
+