[Core] Upgrade guide for model names that contain spaces

[dbeatty10]

Link to the page(s) on docs.getdbt.com requiring updates

Migration guide for v1.8

Tell us more about this update

For folks that have a model name that contains spaces, provide instructions for how to upgrade via custom aliases.

Before

models/my model.sql

select 1 as id

models/_models.yml

models:
  - name: "my model"

After - option 1

models/my_model.sql

{{ config(alias="my model") }}

select 1 as id

models/_models.yml

models:
  - name: "my model"

After - option 2

models/my_model.sql

select 1 as id

models/_models.yml

models:
  - name: my_model
    config:
      alias: "my model"

Reviewers/Stakeholders/SMEs

.

Related GitHub issues

• [CT-3564] for deprecation - we should not support spaces in model names dbt-core#9397
• Begin warning people about spaces in model names dbt-core#9886
• [Core] We won't support spaces in model names #5275
• Deprecating support for spaces #5295

Additional information

No response