Skip to content

Commit ffad516

Browse files
Apply suggestions from code review
Co-authored-by: Daniel Mangum <31777345+hasheddan@users.noreply.github.com>
1 parent 83bbb8d commit ffad516

File tree

1 file changed

+6
-6
lines changed
  • docs/device-management/5-ota/5-migrating-from-releases

1 file changed

+6
-6
lines changed

docs/device-management/5-ota/5-migrating-from-releases/README.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Migrating From Releases
22

3-
The Cohorts workflow for rolling out OTA updates to devices are a direct
3+
The Cohorts workflow for rolling out OTA updates to devices is a direct
44
replacement of the old Releases workflow. Releases are already disabled for all
55
new projects, and will be disabled for all existing projects at a later stage.
66

@@ -10,7 +10,7 @@ we recommend transitioning to Cohorts as soon as possible.
1010
## Differences between Releases and Cohorts
1111

1212
Cohorts bring two fundamental upgrades to the way OTA Updates are distributed
13-
from your devices. The most important change is that you now have to explicitly
13+
to your devices. The most important change is that you now have to explicitly
1414
add a device to a Cohort, instead of relying on the blueprint and tags matching
1515
mechanism in Releases and Artifacts. The second fundamental change is the way
1616
each update is rolled out — with Releases, each Release could be enabled and
@@ -58,7 +58,7 @@ are a couple of smaller differences between Releases and Cohorts:
5858

5959
- **Adding a device to a Cohort will push a manifest update to the device right
6060
away.** With Releases, devices would only receive an update notification when
61-
you rolled out a Release, but could still pull for the active Release between
61+
you rolled out a Release, but could still poll for the active Release between
6262
roll outs. With Cohorts, the active Deployment is always issued to every
6363
device in the Cohort as soon as possible.
6464
- **Artifact blueprints are no longer considered.** If a Deployment contains an
@@ -85,7 +85,7 @@ anything in your firmware.
8585
## Moving devices to Cohorts
8686

8787
As a device has to be part of a Cohort to receive Deployments, you can opt into
88-
the new workflow on a device-to-device basis.
88+
the new workflow on a per device basis.
8989

9090
To make sure your migration from Releases to Cohorts doesn't trigger any
9191
accidental OTA updates, we recommend testing the new concept by moving a test
@@ -124,8 +124,8 @@ workflow for some time. To move a device back to using Releases, you can remove
124124
it from the Cohort. This causes the device to receive OTA updates using the old
125125
Releases workflow, as if it never belonged to a Cohort. Note that moving the
126126
device out of a Cohort does not trigger an OTA manifest update on the device,
127-
even if it starts being affected by a Release. However, the next time the device
128-
reads the OTA manifest, the Golioth Cloud will respond with whatever release
127+
even if there is an active Release that targets it. However, the next time the device
128+
fetches the OTA manifest, the Golioth Cloud will respond with whatever release
129129
manifest the device should receive through the Releases workflow.
130130

131131
## Disabling the Releases workflow for your project

0 commit comments

Comments
 (0)