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

Release Policy: Update docs and screenshots #2679

Merged
merged 1 commit into from
Apr 24, 2023

Conversation

myarmolinsky
Copy link
Member

Release Policy: Update docs and screenshots

Change-type: patch


Please make sure to read the CONTRIBUTING document before opening the PR for relevant information on contributing to the documentation. Thanks!

@myarmolinsky myarmolinsky self-assigned this Apr 21, 2023
@myarmolinsky myarmolinsky marked this pull request as ready for review April 21, 2023 17:05
@flowzone-app flowzone-app bot enabled auto-merge April 21, 2023 17:06
pages/learn/deploy/release-strategy/release-policy.md Outdated Show resolved Hide resolved
<img src="/img/common/release-policy/mNCaLF8.gif" width="100%" alt="Pin fleet to release">
You can also pin a fleet to a release via the CLI as follows:
- Pin to a specific release: `balena fleet pin myorg/myfleet 91165e5`
- Track latest: `balena fleet track-latest myorg/myfleet`

## Pin device to a release

As well as pinning a fleet to a specific release, you may pin individual devices to a specific release. By default, all devices track the fleet release. However, you may wish to run a different release on select devices, for example, a development device or when performing a [canary deployment][canary].
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
As well as pinning a fleet to a specific release, you may pin individual devices to a specific release. By default, all devices track the fleet release. However, you may wish to run a different release on select devices, for example, a development device or when performing a [canary deployment][canary].
Same as pinning a fleet to a specific release, you can pin individual devices to a specific release. By default, all devices track the fleet release. However, you may wish to run a different release on select devices, for example, a development device or when performing a [canary deployment][canary].

Copy link
Member Author

Choose a reason for hiding this comment

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

Same isn't better semantically IMO, but I'll admin that As well is a bit odd... Arguably we really don't need that first sentence at all, right? It's implied by the existence of this doc section, isn't it?

Copy link
Member

Choose a reason for hiding this comment

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

True that. Less is more.

pages/learn/deploy/release-strategy/release-policy.md Outdated Show resolved Hide resolved
pages/learn/deploy/release-strategy/release-policy.md Outdated Show resolved Hide resolved
Comment on lines 36 to 54
You can also pin a device to a release via the CLI as follows:
- Pin to a specific release: `balena device pin 7cf02a6 91165e5`
- Track latest: `balena device track-fleet 7cf02a6`
Copy link
Member

Choose a reason for hiding this comment

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

repetition of info? from L18

Copy link
Member Author

Choose a reason for hiding this comment

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

The commands look similar but they're not. For each section we have device vs fleet, and the second bullet is a different command track-latest vs track-fleet

@myarmolinsky myarmolinsky force-pushed the update-release-policy-docs branch 3 times, most recently from 752e4ad to 42b93ab Compare April 24, 2023 11:44
@flowzone-app flowzone-app bot merged commit 8531a2e into master Apr 24, 2023
@flowzone-app flowzone-app bot deleted the update-release-policy-docs branch April 24, 2023 12:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants