Emmyoop patch 3

[emmyoop]

Description & motivation

Updating docs for some dbt-core v1.0.0 changes.

dbt-labs/dbt-core#4008
dbt-labs/dbt-core#4007
dbt-labs/dbt-core#3999

To-do before merge

dbt-core v1.0.0 needs to be released

Pre-release docs

Is this change related to an unreleased version of dbt?

• Yes: please
  • update the base branch to next
  • add Changelog components: <Changelog>[New/Changed] in v0.x.0</Changelog>
  • add links to the "New and changed documentation" section of the latest Migration Guide
• No: please ensure the base branch is current
• Unsure: we'll let you know!

Checklist

Renamed pages:

• The pages have been updated in website/sidebars.js
• The pages have unique filenames
• Entries have been added to _redirects

[emmyoop]

Unsure of where to put changelog entries for each change.

[jtcohen6]

Thank you for these updates !!

I left way too many comments. As a general rule:

• Wherever we're documenting The Thing (model-paths, seed-properties, etc), we should include a <Changelog> item, just calling out that the config/default has been renamed
• If we're just updating the name of a file in an example, no big deal, I don't think we need a changelog
• In a bunch of places, the current docs refer to a limited number of places where sources/exposures/properties can be defined. Instead, we should clarify that they can be defined in any resource path, and (in the case of properties) that we highly encourage defining them in the resource path associated with the resource type they're describing. I think it's confusing to call out model-paths as an alternative / backwards-compatible option

As soon as you're happy with these docs, we can merge them into the next branch and deploy them at next.docs.getdbt.com. I'm probably going to merge #836 first, so there will be some conflicting changes to resolve/rebase, namely in the migration guide.

[jtcohen6]

this will be a broken link until we update the jaffle_shop repo - what do you think of leaving this as is for now, and leaving ourselves a TODO?

[emmyoop]

What about linking to the branch where it does exist? https://github.com/dbt-labs/jaffle_shop/blob/core-v1.0.0/seeds/raw_payments.csv

[jtcohen6]

that works!

[jtcohen6]

Thanks for all the hard work to get these right !!

There might be a few stragglers, which we can catch them over the next several weeks — at this point, it feels more important to get the vast majority of the updates in.