dbt-labs / dbt-labs/docs.getdbt.com

general or specific configs on snapshot docs?

Open
#8,777 0 comments 0 reactions 0 assignees View on GitHub
content improvement
Dominant language
JavaScript
Stars
215
Forks
1.2k
Avg merge
1d 15h
Merged PRs (30d)
130

Description

### Contributions

- [x] I have read the contribution docs, and understand what's expected of me.

### Link to the page on docs.getdbt.com requiring updates

https://docs.getdbt.com/reference/snapshot-configs?version=1.12

### What part(s) of the page would you like to see updated?

We list out snapshot configurations [here](https://docs.getdbt.com/reference/snapshot-configs?version=1.12):
```
snapshots:
:
+schema:
+database:
+alias:
+unique_key:
+strategy: timestamp | check
+updated_at:
+check_cols: [] | all
+snapshot_meta_column_names: {}
+dbt_valid_to_current:
+hard_deletes: string
```

We say "The following resource-specific configurations are only available to Snapshots:" but `schema`, `database`, and `alias` are _general_ configs.

Similarly, on the `post-hook` / `pre-hook` [docs pages](https://docs.getdbt.com/reference/resource-configs/pre-hook-post-hook?version=1.12), we have an example for `snapshots`:
```
snapshots:
- name: []
config:
pre_hook: | []
post_hook: | []
```
(other small nit, why is `snapshot_name` in `[ ]`? it's not a list?)

Which are other general configs you can apply to snapshots.

We should make a decision here: should snapshots docs show all configs you can use for snapshots? Or only the ones _specific_ to snapshots?

### Additional information

_No response_

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.