The resource-path configuration applies to many (all?) resource types

[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/resource-path

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

The resource-path page only explains how it applies to:

• models
• seeds
• snapshots

But it applies to other resource types as well:

• tests
• sources
• potentially others

Additional information

The problem

dbt-labs/dbt-core#8876 specifically mentioned that they were expecting this section to apply to tests also:

The <resource-path> nomenclature is used in this documentation when documenting how to configure a model, seed, or snapshot, from your dbt_project.yml file. It represents the nested dictionary keys that provide the path to either a directory of models, or a single model.

The "info" section is also relevant:

This example is for models, but the same concepts apply for seeds and snapshots.

But these sections only explain three node types and don't cover the other ones.

Potential solution

The key insight is that it should be something like this instead:

It represents the nested dictionary keys that provide the path to a directory of that resource type, or a single instance of that resource type by name.

e.g.

<resource type>:
  <project name>:
    <directory name>:
      <subdirectory name>:
        <instance of resource type (by name)>:
          ...

Related issues

• [CT-3242] [Bug] adding a where clause to all tests of a single model doesn't work as documentation states dbt-core#8876
• [CT-3301] [Bug] sources are not disabled in dbt_project.yml dbt-core#8960

[mirnawong1]

hey @dbeatty10 ! thank you for this, I've created a PR here which addresses the above and also other items such as this this core issue