Clarify ways of defining generic tests (macros or test paths)

[mirnawong1]

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/best-practices/writing-custom-generic-tests

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

In the dbt community slack, a community member raised that we configure generic tests using macro code snippets in this article, however we miss explaining why there are two ways of configure tests, the difference between them, and when to use which one.

We can maybe use a table to convey this and as DX for help.

I liked the docs for tests and generic tests, but got confused by the external links because they use macros instead of the test keyword:
https://docs.getdbt.com/best-practices/writing-custom-generic-tests
I think it would be helpful to add a paragraph about why there are two ways of doing the same thing, how they differ and which to use right before the links or incorporating the linked examples in the documentation in a good way.

Additional information

No response