diff --git a/docs/explanation/how-snaps-work/channels-and-tracks.md b/docs/explanation/how-snaps-work/channels-and-tracks.md index ac3da92..d38fbc7 100644 --- a/docs/explanation/how-snaps-work/channels-and-tracks.md +++ b/docs/explanation/how-snaps-work/channels-and-tracks.md @@ -27,44 +27,41 @@ snap install vlc --channel=latest/edge Developers can optionally choose whether to supplement the default _latest_ track with additional tracks. The developer is also free to designate one of these as the default track to be installed when no further preference is given. -Microsoft's [Skype snap](https://snapcraft.io/skype) is a good example of how tracks can be used. It contains two tracks: the default _latest_ track for the majority of users, and an _insider_ track for Microsoft's QA team and users interested in testing the latest Skype developments ahead of a stable release. +Mozilla's [Firefox snap](https://snapcraft.io/firefox) is a good example of how tracks can be used. It contains two tracks: the default _latest_ track for the majority of users, and an _esr_ track for the version of Firefox with [extended support](https://www.firefox.com/en-GB/browsers/enterprise/). Equally, a track could also be used to track minor updates (2.0.1, 2.0.2), major updates (2.1, 2.2), or releases held for long-term support (3.2, 4.1). Tracks are listed in the *channels* section of the output from the `snap info` command: ``` -$ snap info skype +$ snap info firefox [...] -channels: - stable: 8.28.0.41 (51) 148MB classic - candidate: ↑ - beta: ↑ - edge: ↑ - insider/stable: 8.30.76.41 (53) 151MB classic - insider/candidate: ↑ - insider/beta: ↑ - insider/edge: ↑ +hannels: + latest/stable: 149.0.2-1 2026-04-08 (8107) 287MB - + latest/candidate: 150.0-1 2026-04-16 (8172) 288MB - + latest/beta: 150.0b10-1 2026-04-15 (8166) 288MB - + latest/edge: 151.0a1 2026-04-17 (8175) 310MB - + esr/stable: 140.9.1esr-1 2026-04-07 (8106) 259MB - + esr/candidate: 140.10.0esr-1 2026-04-15 (8162) 259MB - + esr/beta: ↑ + esr/edge: ↑ [...] ``` -In the above output, the [Skype](https://snapcraft.io/skype) snap includes the custom *insider* track. You can also see which tracks a snap supports by clicking *Other versions* from its online Store entry. +In the above output, the Firefox snap includes the custom *esr* track. You can also see which tracks a snap supports by clicking *Other versions* from its online Store entry. -To install Skype from its *insider* track, for example, use the following -command: +To install Firefox from its *insider* track, for example, use the following command: ``` -snap install skype --channel=insider/stable +snap install firefox --channel=esr/stable ``` -A user who already has Skype installed can switch channel with the ``snap refresh`` command: +If you already have Firefox installed, you can switch channel with the ``snap refresh`` command: ``` -snap refresh skype --channel=insider/stable +snap refresh firefox --channel=esr/stable ``` -Alternatively if using GNOME Software, select the ‘stable’ channel in the store page for Skype, and select a channel to switch to. - Developers must currently make a request for tracks to be added to their snap via the [#store-requests](https://forum.snapcraft.io/c/store-requests) forum category. Releases are verified and checked to ensure that reasonable user expectations are being met. For example, only _3.2.*_ versions are accepted into a _3.2_ track. ## Risk-levels diff --git a/docs/explanation/how-snaps-work/snap-deltas.md b/docs/explanation/how-snaps-work/snap-deltas.md index 5c11efe..59727dc 100644 --- a/docs/explanation/how-snaps-work/snap-deltas.md +++ b/docs/explanation/how-snaps-work/snap-deltas.md @@ -19,9 +19,12 @@ Snap deltas are completely transparent to the developer and there is no way to d Download deltas are enabled by default in _snapd 2.23+_. -### Saving space with deltas +## Upload deltas + +Upload deltas effectively use the same mechanism as download deltas, with the main difference being that the delta is generated locally by Snapcraft when a developer initiates an upload for a new version of their snap. The delta contains only the differences between the most recently uploaded revision and the new local revision. Once uploaded, the Snap Store applies the delta to reconstruct the complete snap, verifying its integrity via its digital signature. + +## Saving space with deltas The space savings provided by deltas vary depending on the size of the snap, how often it gets updated, and how compressible the snap is (snaps that can be compressed into a small size will benefit less from deltas than snaps that are difficult to compress). In practice, the delta download size is around 30% of the full snap size. The exact size of a delta can be determined with `snap refresh`. - diff --git a/docs/explanation/how-snaps-work/transactional-updates.md b/docs/explanation/how-snaps-work/transactional-updates.md index 886d347..67bb874 100644 --- a/docs/explanation/how-snaps-work/transactional-updates.md +++ b/docs/explanation/how-snaps-work/transactional-updates.md @@ -7,7 +7,7 @@ This can help when a set of snaps with specific revisions are tested to ensure t Transactional updates can also help when you know that one snap is dependent on a specific revision of another, or when you need multiple snaps to update at the same time. On the firmware for device running Ubuntu Core, for example, it can help to update both the kernel snap and the gadget snap at the same time. Transactional updates enable this. -A transactional update or installation can be instantiated from either the **snap** command, or from the SnapD REST API. +A transactional update or installation can be instantiated from either the **snap** command, or from the [SnapD REST API](https://snapcraft.io/docs/reference/development/snapd-rest-api/). ## Transactional updates from the snap command diff --git a/docs/redirects.txt b/docs/redirects.txt index d442148..9b5d46d 100644 --- a/docs/redirects.txt +++ b/docs/redirects.txt @@ -12,6 +12,9 @@ # Example: # redirect/from/file/ redirect/to/file/ +# Redirects added after RTD migration +quickstart-tour/ tutorials/get-started/ + # RTD reconfiguration how-to-guides/snap-development/api/redoc-static.html reference/development/snapd-rest-api snapd-api/ reference/development/snapd-rest-api diff --git a/docs/reference/interfaces/wayland-interface.md b/docs/reference/interfaces/wayland-interface.md index 59bcf81..2aaec4f 100644 --- a/docs/reference/interfaces/wayland-interface.md +++ b/docs/reference/interfaces/wayland-interface.md @@ -3,7 +3,7 @@ `wayland` allows access to compositors supporting Wayland protocol. -**Auto-connect**: yes +**Auto-connect**: yes, except on Ubuntu Core **Transitional**: yes See The desktop interfaces for further details.