Rephrase the two criteria for resolving ref calls with the --defer flag

[dbeatty10]

resolves #6332

What are you changing in this pull request and why?

There's a ton more detail in #6332, but the TLDR is:

• --defer, --state, and --favor-state are tricky, so we want to make it as easy to understand as possible.

🎩

The proposed text is as follows:

Usage

By default, dbt uses the target namespace to resolve ref calls.

But with --defer, dbt will use the state manifest instead if the following criteria are met:

1. The node isn’t in the selected nodes and
2. It doesn’t exist in the database (or --favor-state is used).

Favor state

If --favor-state is passed, dbt will favor the node definition from the --state directory, unless that node is also included among the selected nodes.

Checklist

• I have reviewed the Content style guide so my content adheres to these guidelines.

---

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

• https://docs-getdbt-com-git-dbeatty10-patch-1-dbt-labs.vercel.app/reference/node-selection/defer

[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	Dec 13, 2024 10:01am

[mirnawong1]

thank you for the context @dbeatty10 , some small tweaks and looks great!