add callout for net new snapshots

website/docs/reference/snapshot-configs.md

@@ -13,11 +13,6 @@
 * [Snapshots](/docs/build/snapshots)
 * The `dbt snapshot` [command](/reference/commands/snapshot)
 
-<!--
-Parts of a snapshot:
-- name
-- query
--->
 
 ## Available configurations
 ### Snapshot-specific configurations
@@ -125,7 +120,7 @@
 
 <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.
+Configurations can be applied to snapshots using the [YAML syntax](/docs/build/snapshots#configuring-snapshots), available in Versionless and dbt v1.9 and higher, in the `snapshot` directory file.
 
 </VersionBlock>
 
@@ -155,6 +150,17 @@
 
 <ConfigGeneral />
 
+:::tip
+
+Configuring snapshots in YAML is recommended for new snapshot configurations. If you have existing snapshots using the `.sql` config, they'll continue to work as expected. When you're ready to migrate to YAML, we recommend:
+1. Creating a backup copy of your snapshots (or using version control)
+2. Converting the configurations one at a time, testing as you go
+3. Using `alter` statements as needed to ensure table consistency or using a script to apply the `alter` statements
+
+The YAML configuration offers improved maintainability and consistency, but there's no pressure to migrate existing snapshots immediately &mdash; feel free to do so at your own pace while ensuring data quality is maintained.
+:::
+
+
 <Tabs
   groupId="config-languages"
   defaultValue="project-yaml"
@@ -170,6 +176,7 @@
 
 <VersionBlock firstVersion="1.9">
 
+
 ```yaml
 snapshots:
   [<resource-path>](/reference/resource-configs/resource-path):
@@ -256,7 +263,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.
+Configurations can be applied to snapshots using [YAML syntax](/docs/build/snapshots#configuring-snapshots), available in Versionless and dbt v1.9 and higher, in the `snapshot` directory file.
 
 </VersionBlock>