Update persist_docs

[jtcohen6]

Contributions

• 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/resource-configs/persist_docs

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

Clarify that column names must match exactly between yaml specification and model SQL (i.e. the way the columns are created in the database). Specifically, the comparisons are case-sensitive. This has come up in two recent issues:

• [CT-566] [CT-560] [Bug] column description is not sent to BigQuery dbt-bigquery#169
• [CT-575] [Bug] 1.0.0 Cannot execute an empty query dbt-core#5183

---

Also, this statement is no longer true as of v1.0:

Column-level comments are not supported on Snowflake views

There are two related issues to be aware of, however:

• Use lowercase / case-insensitive comparison when persisting column-level comments for views dbt-snowflake#73
• [CT-331] Views with persist_docs on columns: check to see if any comments first dbt-snowflake#102

Additional information

No response

[jtcohen6]

Resolved by #1666