Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Naming conventions - #9675

#9675
Open
nataliefiann wants to merge 1 commit into
currentdbt-labs/docs.getdbt.com:currentfrom
nfiann-globalruledbt-labs/docs.getdbt.com:nfiann-globalruleCopy head branch name to clipboard
Open

Naming conventions#9675
nataliefiann wants to merge 1 commit into
currentdbt-labs/docs.getdbt.com:currentfrom
nfiann-globalruledbt-labs/docs.getdbt.com:nfiann-globalruleCopy head branch name to clipboard

Conversation

@nataliefiann

@nataliefiann nataliefiann commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

Closes JIRA:PRODDOCS-991

This PR:

  • Clarifies the YAML naming convention guidance on the dbt_project.yml reference page so it no longer presents dashes as a blanket rule.

  • The previous docs said multi-word resource types in dbt_project.yml always use dashes, but data_tests and unit_tests intentionally use underscores everywhere (including dbt_project.yml). That mismatch caused user confusion.

  • Soften the dash guidance to “most” multi-word resource types

  • Document the data_tests / unit_tests underscore exception with an example

  • Keep the existing outside-dbt_project.yml underscore guidance

  • Minor style cleanup on related “refer to” link wording (_plus-prefix snippet)
    Related: dbt-core#9201, dbt-core#9235

Checklist


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

@nataliefiann
nataliefiann requested a review from a team as a code owner July 23, 2026 16:10
@vercel

vercel Bot commented Jul 23, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs-getdbt-com Ready Ready Preview Jul 23, 2026 4:13pm

Request Review

@github-actions github-actions Bot added the content Improvements or additions to content label Jul 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content Improvements or additions to content

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

Morty Proxy This is a proxified and sanitized view of the page, visit original site.