Keeping the original filename and table name when versioning for first time

[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/docs/collaborate/govern/model-versions

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

These changes need to be reviewed for completeness and correctness.

The instigating issue was this this didn't work for me:

  - v: 1
    config:
      alias: dim_customers # keep old relation location

This is what worked for me to keep both the filename and the table name the same as when it was un-versioned:
models/_models.yml

models:
  - name: dim_customers
    versions:
      - v: 1
        defined_in: dim_customers  # keep original file name

models/dim_customers.sql

{{ config(alias="dim_customers") }}

...

After my changes in #3195, this is not accurate 😢 :

defined_in: dim_customers # keep original relation name

It should be something like this instead:

defined_in: dim_customers # keep original file name

Additional information

No response