Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Narrative: Model versions #2841

Closed
1 task done
Tracked by #6747
jtcohen6 opened this issue Feb 9, 2023 · 1 comment
Closed
1 task done
Tracked by #6747

Narrative: Model versions #2841

jtcohen6 opened this issue Feb 9, 2023 · 1 comment
Labels
content Improvements or additions to content dbt-core v1.5 Docs impact for the v1.5 release (Apr 2023) improvement Use this when an area of the docs needs improvement as it's currently unclear Initialize Docs are ready for framework size: large This change will more than a week to address and might require more than one person
Milestone
dbt Core v1.5 Doc...

Comments

@jtcohen6
Copy link
Collaborator

jtcohen6 commented Feb 9, 2023 •
edited
Loading

Contributions

  • I have read the contribution docs, and understand what's expected of me.

Link to the page on docs.getdbt.com requiring updates

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

Full motivation & context in:

Eventually, our docs should seek to cover:

  • Why our recommended versioning scheme? (per-model, API/major version only)
  • When is it necessary to version a model?
  • As the producer of a versioned model:
    • How can I define a model's version? Can I optionally specify which model is the "latest"?
    • How can I DRY-ly define config/properties for multiple model versions at once?
    • When should a model be marked for deprecation (define a deprecation_date)?
  • As the consumer of a versioned model:
    • How can I ref a versioned model?
    • What can I expect to see if I ref a model that's slated for deprecation?

We'll plan to open more narrowly scoped issues as we go, associated with specific dbt-core PRs

Additional information

No response
@jtcohen6 jtcohen6 added content Improvements or additions to content improvement Use this when an area of the docs needs improvement as it's currently unclear size: large This change will more than a week to address and might require more than one person dbt-core v1.5 Docs impact for the v1.5 release (Apr 2023) blocked_by_dev Awaiting merge of PR with associated functionality labels Feb 9, 2023
@jtcohen6 jtcohen6 mentioned this issue Feb 9, 2023
Closed
@jtcohen6 jtcohen6 added this to the dbt Core v1.5 Documentation milestone Feb 9, 2023
@matthewshaver matthewshaver added the Initialize Docs are ready for framework label Feb 16, 2023
@jtcohen6 jtcohen6 changed the title Model versions Narrative: Model versions Feb 16, 2023
@jtcohen6 jtcohen6 removed the blocked_by_dev Awaiting merge of PR with associated functionality label Feb 19, 2023
@jtcohen6 jtcohen6 mentioned this issue Feb 20, 2023
Merged
5 tasks
@MichelleArk MichelleArk mentioned this issue Feb 27, 2023
Closed
@jtcohen6
Copy link
Collaborator Author

jtcohen6 commented Mar 1, 2023

Added as part of wireframe in #2890, to rewrite/expand later

@jtcohen6 jtcohen6 closed this as completed Mar 1, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
content Improvements or additions to content dbt-core v1.5 Docs impact for the v1.5 release (Apr 2023) improvement Use this when an area of the docs needs improvement as it's currently unclear Initialize Docs are ready for framework size: large This change will more than a week to address and might require more than one person
Projects
None yet
Milestone
dbt Core v1.5 Documentation
Development

No branches or pull requests
2 participants
@jtcohen6 @matthewshaver