Update data test descriptions

[matthewshaver]

What are you changing in this pull request and why?

Generic Test descriptions can now be documented

Closes #6293

Checklist

• I have reviewed the Content style guide so my content adheres to these guidelines.
• The topic I'm writing about is for specific dbt version(s) and I have versioned it according to the version a whole page and/or version a block of content guidelines.
• I have added checklist item(s) to this list for anything anything that needs to happen before this PR is merged, such as "needs technical review" or "change base branch."

---

🚀 Deployment available! Here are the direct links to the updated files:

• https://docs-getdbt-com-git-test-description-dbt-labs.vercel.app/reference/resource-properties/description

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
docs-getdbt-com	✅ Ready (Inspect)	Visit Preview	Oct 24, 2024 1:57pm

[mirnawong1]

hey @matthewshaver , do you think we should modify one of the examples under the 'examples' header to include tests?

e.g.

- name: color
  tests:
    - accepted_values:
        values: ['blue', 'green', 'red']
        description: "{{ doc('color_accepted_values') }}"

[mirnawong1]

also it maybe out of scope but would it be a good idea to link to the description property page here?

[matthewshaver]

Good questions @mirnawong1 - I only updated to stress all data tests in the description. There was an earlier PR from some others that didn't do it then. Maybe because it would be a lot of version blocking

[mirnawong1]

thank you @matthewshaver !

[joellabes]

My vote is to add some examples, even if they're not truly inside of version blocks and just have a comment beside them or something. I was just sharing info on how this worked, and wound up having to backsolve it myself instead of using the docs.

A couple of examples are here if you want to leverage them: https://discourse.getdbt.com/t/is-it-possible-to-add-a-description-to-singular-tests/5472/4