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

Update README to include details on upgrading #297

Merged
merged 2 commits into from
Apr 28, 2023

Conversation

glsdown
Copy link
Contributor

@glsdown glsdown commented Apr 28, 2023

Overview

There were some questions around version numbers and making breaking changes. This introduces instructions to clarify how to handle upgrading the version.

It additionally removes reference to always ensure that the package is included wherever upload_results is used, as this causes concurrency issues as noted in #271.

Update type - breaking / non-breaking

  • Minor bug fix
  • Documentation improvements
  • Quality of Life improvements
  • New features (non-breaking change)
  • New features (breaking change)
  • Other (non-breaking change)
  • Other (breaking change)

What does this solve?

Outstanding questions

N/A

What databases have you tested with?

N/A - no code changes, only documentation

@glsdown glsdown temporarily deployed to Approve Integration Tests April 28, 2023 10:16 — with GitHub Actions Inactive
@glsdown glsdown temporarily deployed to Approve Integration Tests April 28, 2023 10:16 — with GitHub Actions Inactive
@glsdown glsdown temporarily deployed to Approve Integration Tests April 28, 2023 10:16 — with GitHub Actions Inactive
@glsdown glsdown temporarily deployed to Approve Integration Tests April 28, 2023 10:16 — with GitHub Actions Inactive
README.md Outdated Show resolved Hide resolved
README.md Outdated
```
packages:
- package: brooklyn-data/dbt_artifacts
version: 2.3.0
```

:contruction-worker: Make sure to fix at least the **minor** version, to avoid issues when a new release is open. See the notes on upgrading below for more detail.

2. Run `dbt deps` to install the package

3. Add an on-run-end hook to your `dbt_project.yml`: `on-run-end: "{{ dbt_artifacts.upload_results(results) }}"`
Copy link
Member

Choose a reason for hiding this comment

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

Could we add these examples as yml examples like the others as I think it would make it easier to copy and paste for users

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Good plan - change made.

@glsdown glsdown mentioned this pull request Apr 28, 2023
@glsdown glsdown temporarily deployed to Approve Integration Tests April 28, 2023 15:49 — with GitHub Actions Inactive
@glsdown glsdown temporarily deployed to Approve Integration Tests April 28, 2023 15:49 — with GitHub Actions Inactive
@glsdown glsdown temporarily deployed to Approve Integration Tests April 28, 2023 15:49 — with GitHub Actions Inactive
@glsdown glsdown temporarily deployed to Approve Integration Tests April 28, 2023 15:49 — with GitHub Actions Inactive
@glsdown glsdown requested a review from jared-rimmer April 28, 2023 15:49
@glsdown glsdown merged commit 07cf1fd into main Apr 28, 2023
@glsdown glsdown deleted the docs/add-version-update-notes branch April 28, 2023 16:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Feature]: Add instructions to the README for upgrading to minor versions Concurrency Issue
2 participants