Check code examples for the docs config

[dbeatty10]

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/docs
• https://docs.getdbt.com/reference/macro-properties

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

1c959fd added a couple inline "to-do" comments like this:

docs.getdbt.com/website/docs/reference/resource-configs/docs.md

Line 97 in 0cb4856

To-do: check this

So I'd suggest checking if each of these examples work correctly or not. If a code example works, then remove the to-do comment. If it doesn't, then update the docs as-needed.

Example 1 - Macros tab

macros/schema.yml

version: 2
macros:
  - name: macro_name
    docs:
      show: true | false

Example 2 - Macros properties page

version: 2

macros:
  - name: <macro name>
    [description](description): <markdown_string>
    [docs](docs):
      show: true | false
    arguments:
      - name: <arg name>
        type: <arg type>
        [description](description): <markdown_string>
      - ...
  - ...

Additional information

No response