Clarify the relationship between --quiet and --log-level

[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/global-configs/logs#suppress-non-error-logs-in-output

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

The migration guide for v1.5 says:

The dbt list command will now include INFO level logs by default. Previously, the list command (and only the list command) had WARN-level stdout logging, to support piping its results to jq, a file, or another process. To achieve that goal, you can use either of the following parameters:

• dbt --log-level warn list (recommended; equivalent to previous default)
• dbt --quiet list (suppresses all logging less than ERROR level, except for "printed" messages and list output)

We should probably add a similar explanation here.

The key idea is that for the list command, it's often useful to suppress all output except for the actual output of the command. This is done via --quiet or --log-level error and is especially applicable when --output json and the output is being piped into another process or program (like jq). Otherwise, the output will include info-level logs which won't have the expected JSON structure and may lead to parsing errors downsteam.

Additional information

No response