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.

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

"Versionless" -> "Release Tracks" #6471

Merged
merged 11 commits into from
Dec 4, 2024

Conversation

jtcohen6
Copy link
Collaborator

@jtcohen6 jtcohen6 commented Nov 13, 2024

What are you changing in this pull request and why?

We are adding new "release tracks" for automatic upgrades of dbt in dbt Cloud:

  • "Latest" (renamed from "Versionless")
  • "Compatible"
  • "Extended"

The following language needs updating:

  • When we use "Versionless" to describe the way of receiving ongoing/automatic updates to dbt in dbt Cloud, we should instead say "Release Tracks"
  • When we use "Versionless" to describe the continuously updating release track (ahead of dbt Core OSS), we should instead call this "Latest"

I'm also adding a placeholder "Compatible Track Changelog" page, which we will update with each monthly release, starting in December 2024. (I expect the updates will be manual for starters; we can look to automate later.)

Copy link

vercel bot commented Nov 13, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Updated (UTC)
docs-getdbt-com ✅ Ready (Inspect) Visit Preview Dec 4, 2024 8:24pm

@github-actions github-actions bot added content Improvements or additions to content developer blog This content fits on the developer blog. size: medium This change will take up to a week to address labels Nov 13, 2024
@jtcohen6 jtcohen6 force-pushed the jerco/rename-versionless-release-tracks branch from cfc9093 to 16d68d5 Compare December 2, 2024 14:08
@jtcohen6 jtcohen6 marked this pull request as ready for review December 2, 2024 14:08
@jtcohen6 jtcohen6 requested review from dataders and a team as code owners December 2, 2024 14:08
@jtcohen6 jtcohen6 changed the title [WIP] "Versionless" -> "Release Tracks" "Versionless" -> "Release Tracks" Dec 2, 2024
@github-actions github-actions bot added size: large This change will more than a week to address and might require more than one person and removed size: medium This change will take up to a week to address labels Dec 2, 2024
@matthewshaver
Copy link
Contributor

@jtcohen6 In a few spots, we fluctuate between "Latest" and "Release Tracks." Would it be beneficial to consolidate or combine here? Maybe just "Release Tracks" where "Latest" is or "Latest Release Track" for this reset, at least? We could use "Latest" when tagging items during the release process.

@jtcohen6
Copy link
Collaborator Author

jtcohen6 commented Dec 3, 2024

@nataliefiann @matthewshaver Thanks for taking a look!

There's a nuance that feels important to capture:

  • "Release tracks" describes the mechanism of automatic upgrades that will be how dbt Cloud customers get ongoing updates going forward.
  • When it comes to specific functionality that we've released over the last several months, much of this functionality is available only on the "Latest" release track today. It will be available on the "Compatible" release track only after it's been released in dbt Core v1.9. (That's happening next week.) Customers using "Compatible" should generally look at the docs for the most recent Core release (which will be v1.9 as of next week) to understand what functionality they have access to.

I do like the point of referring to this consistently as "Latest release track" (instead of just "Latest"). I'll do a re-review of the changes now and try to update it everywhere for consistency.

When we actually release Compatible/Extended next week (after the v1.9 final release), I'll plan to swing back with another docs update for:

  • Compatible + Extended - coming soonpreview
  • 1.9 in version dropdown → customDisplay: "1.9 (Compatible)"

Copy link
Collaborator

@runleonarun runleonarun left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixing build error

website/docs/docs/build/metrics-overview.md Outdated Show resolved Hide resolved
Copy link
Collaborator

@runleonarun runleonarun left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@matthewshaver I feel like the three releases were hard to understand the differences so I made the paragraphs parallel. You get a continuous, monthly, or delayed release. Feel free to iterate further.

website/docs/docs/dbt-versions/cloud-release-tracks.md Outdated Show resolved Hide resolved
website/docs/docs/dbt-versions/cloud-release-tracks.md Outdated Show resolved Hide resolved
website/docs/docs/dbt-versions/cloud-release-tracks.md Outdated Show resolved Hide resolved
website/docs/docs/dbt-versions/cloud-release-tracks.md Outdated Show resolved Hide resolved
@github-actions github-actions bot removed content Improvements or additions to content developer blog This content fits on the developer blog. labels Dec 4, 2024
@vercel vercel bot requested a deployment to Preview December 4, 2024 19:04 Abandoned
Copy link
Collaborator

@runleonarun runleonarun left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Made changes and will follow up with a PR to make capitalization more consistent.

@runleonarun runleonarun merged commit ec7c48a into current Dec 4, 2024
8 of 9 checks passed
@runleonarun runleonarun deleted the jerco/rename-versionless-release-tracks branch December 4, 2024 22:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
size: large This change will more than a week to address and might require more than one person
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants