From 3b1cee17ce22b39c0a0142d70466359b76eefce4 Mon Sep 17 00:00:00 2001
From: Arthur <arthur.flageul@docker.com>
Date: Wed, 30 Jul 2025 10:05:59 +0200
Subject: [PATCH 01/13] add deprecated summary

---
 layouts/shortcodes/summary-bar.html | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/layouts/shortcodes/summary-bar.html b/layouts/shortcodes/summary-bar.html
index 172f81c61966..0ef920728dc8 100644
--- a/layouts/shortcodes/summary-bar.html
+++ b/layouts/shortcodes/summary-bar.html
@@ -18,6 +18,7 @@
     "Early Access" "rocket_launch"
     "GA" "check_circle"
     "Retired" "package_2"
+    "Deprecated" "warning"
   }}
   {{ $requiresIcon := "browser_updated" }}
   {{ $forIcon := "admin_panel_settings" }}
@@ -45,7 +46,7 @@
 
     {{ with $feature.availability }}
       {{ $availabilityText := . }}
-      <div class="flex flex-wrap gap-1">
+      <div class="flex flex-wrap gap-1 {{ $availabilityText|lower }}">
         <span class="font-bold">Availability:</span>
         <span>
           {{ $availabilityText }}

From 1adc93fa37c7490511201ac000f246d2da1d0506 Mon Sep 17 00:00:00 2001
From: Arthur <arthur.flageul@docker.com>
Date: Wed, 30 Jul 2025 10:10:00 +0200
Subject: [PATCH 02/13] add summary snippet

---
 .vscode/docker.code-snippets | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/.vscode/docker.code-snippets b/.vscode/docker.code-snippets
index 3be817d524d4..63966cc1698d 100644
--- a/.vscode/docker.code-snippets
+++ b/.vscode/docker.code-snippets
@@ -54,4 +54,14 @@
     "body": ["{{< button url=\"$1\" text=\"$2\" >}}"],
     "description": "Insert a Hugo button",
   },
+  "Insert a Summary Bar": {
+    "prefix": ["summary-bar"],
+    "body": [
+      "{{< summary-bar feature_name=\"$1\" >}}",
+      "",
+      "$2",
+    ],
+    "description": "Insert a Hugo summary bar with a feature name and content. Define your summary key in data/summary.yaml.",
+  },
+
 }
\ No newline at end of file

From 7f36fdd0fd4dea83b89faabb01786854d37a091b Mon Sep 17 00:00:00 2001
From: Arthur <arthur.flageul@docker.com>
Date: Wed, 30 Jul 2025 10:10:07 +0200
Subject: [PATCH 03/13] hugo stats

---
 hugo_stats.json | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/hugo_stats.json b/hugo_stats.json
index a87826249e0d..7e45d1ea47e9 100644
--- a/hugo_stats.json
+++ b/hugo_stats.json
@@ -2,6 +2,7 @@
   "htmlElements": {
     "tags": null,
     "classes": [
+      "$availabilityText",
       "--mount",
       "--tmpfs",
       "-mt-8",
@@ -34,6 +35,7 @@
       "DNS-resolution",
       "Debian",
       "Debian-GNU/Linux",
+      "Deprecated",
       "Diff",
       "Docker-Build-Cloud",
       "Docker-Desktop",
@@ -148,6 +150,7 @@
       "Without-systemd",
       "[display:none]",
       "absolute",
+      "access",
       "admonition",
       "admonition-content",
       "admonition-danger",
@@ -159,6 +162,7 @@
       "admonition-warning",
       "aspect-video",
       "bake-action",
+      "beta",
       "bg-amber-500",
       "bg-background-toc",
       "bg-black/100",
@@ -268,6 +272,7 @@
       "dark:text-magenta-dark",
       "dark:text-white",
       "dark:to-blue-400",
+      "deprecated",
       "docker/bake-action",
       "docker/build-push-action",
       "download-links",
@@ -275,6 +280,8 @@
       "drop-shadow",
       "dropdown-base",
       "duration-300",
+      "early",
+      "experimental",
       "fill-blue",
       "fixed",
       "flex",
@@ -536,6 +543,7 @@
       "tab-item",
       "tablist",
       "tabs",
+      "text",
       "text-2xl",
       "text-base",
       "text-black",
@@ -577,6 +585,8 @@
       "w-[1200px]",
       "w-[500px]",
       "w-full",
+      "w-screen",
+      "whitespace-normal",
       "whitespace-nowrap",
       "xl:flex",
       "xl:flex-row",

From dfa1df9799d7affa12e27b1f97ec6dc814b43821 Mon Sep 17 00:00:00 2001
From: Arthur <arthur.flageul@docker.com>
Date: Wed, 30 Jul 2025 10:10:25 +0200
Subject: [PATCH 04/13] update summary.yaml

---
 data/summary.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/data/summary.yaml b/data/summary.yaml
index b7d498eb2321..3a423d7f95b3 100644
--- a/data/summary.yaml
+++ b/data/summary.yaml
@@ -133,8 +133,6 @@ Composefile include:
   requires: Docker Compose [2.20.0](/manuals/compose/releases/release-notes.md#2200) and later
 Compose sbom:
   requires: Docker Compose [2.39.0](/manuals/compose/releases/release-notes.md#2390) and later
-containerd:
-  availability: Experimental
 Dev Environments:
   availability: Beta
 Docker Build Cloud:
@@ -250,3 +248,5 @@ Wasm workloads:
   availability: Beta
 Wasmtime:
   availability: Experimental
+StorageDrivers:
+  availability: Deprecated

From bad316c8591548bd89c636e244e77f891ddc3c68 Mon Sep 17 00:00:00 2001
From: Arthur <arthur.flageul@docker.com>
Date: Wed, 30 Jul 2025 10:23:00 +0200
Subject: [PATCH 05/13] support "text" param

---
 layouts/shortcodes/summary-bar.html | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/layouts/shortcodes/summary-bar.html b/layouts/shortcodes/summary-bar.html
index 0ef920728dc8..cf17a6f257e4 100644
--- a/layouts/shortcodes/summary-bar.html
+++ b/layouts/shortcodes/summary-bar.html
@@ -1,4 +1,5 @@
 {{ $featureName := .Get "feature_name" }}
+{{ $text := .Get "text" }}
 {{ $feature := index site.Data.summary $featureName }}
 {{ if not $feature }}
   {{ errorf "[summary-bar] invalid feature: %s %v" $featureName .Position }}
@@ -47,15 +48,16 @@
     {{ with $feature.availability }}
       {{ $availabilityText := . }}
       <div class="flex flex-wrap gap-1 {{ $availabilityText|lower }}">
+        {{ range $key, $icon := $availabilityIcons }}
+          {{ if in $availabilityText $key }}
+            <span class="icon-svg">{{ partial "icon" $icon }}</span>
+          {{ end }}
+        {{ end }}
         <span class="font-bold">Availability:</span>
         <span>
-          {{ $availabilityText }}
-          {{ range $key, $icon := $availabilityIcons }}
-            {{ if in $availabilityText $key }}
-              <span class="icon-svg">{{ partial "icon" $icon }}</span>
-            {{ end }}
-          {{ end }}
+          {{ $availabilityText }}.
         </span>
+        <div> <span class="">{{ $text | markdownify }}</span></div>
       </div>
     {{ end }}
 

From 1ccbaef90a34a4490061f4d643770c8d6b2fcf4e Mon Sep 17 00:00:00 2001
From: Arthur <arthur.flageul@docker.com>
Date: Wed, 30 Jul 2025 10:29:43 +0200
Subject: [PATCH 06/13] update css for deprcated warning

---
 assets/css/components.css | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/assets/css/components.css b/assets/css/components.css
index 1e3f897903fb..d98f3f224fc1 100644
--- a/assets/css/components.css
+++ b/assets/css/components.css
@@ -101,6 +101,9 @@
 .summary-bar {
   @apply my-1 mt-4 flex flex-col rounded-sm border-1 border-gray-100 bg-gray-50 p-4 dark:border-gray-800 dark:bg-gray-900;
 }
+.summary-bar:has(.deprecated) {
+  @apply bg-red-100 dark:bg-red-950;
+}
 
 .tabs {
   @apply bg-blue/2 rounded-sm p-2;

From 27b5f022cbf908f2a46232080c69e7bda51ff1ea Mon Sep 17 00:00:00 2001
From: Arthur <arthur.flageul@docker.com>
Date: Wed, 30 Jul 2025 10:50:54 +0200
Subject: [PATCH 07/13] add title snippet

---
 .vscode/docker.code-snippets | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/.vscode/docker.code-snippets b/.vscode/docker.code-snippets
index 63966cc1698d..8d86bc0fd7fe 100644
--- a/.vscode/docker.code-snippets
+++ b/.vscode/docker.code-snippets
@@ -63,5 +63,18 @@
     ],
     "description": "Insert a Hugo summary bar with a feature name and content. Define your summary key in data/summary.yaml.",
   },
-
+  "Insert Title": {
+    "prefix": ["insert title", "frontmatter", "title"],
+    "body": [
+      "---",
+      "title: $1",
+      "weight: $2",
+      "description: $3",
+      "keywords: $4",
+      "aliases:",
+      "  - $5",
+      "---"
+    ],
+    "description": "Insert a frontmatter block with title, weight, description, keywords, and aliases."
+  }
 }
\ No newline at end of file

From 91d2109a70a3561cb3065415ea9ea31baa525cf7 Mon Sep 17 00:00:00 2001
From: Arthur <arthur.flageul@docker.com>
Date: Wed, 30 Jul 2025 10:51:00 +0200
Subject: [PATCH 08/13] update terms

---
 _vale/config/vocabularies/Docker/accept.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_vale/config/vocabularies/Docker/accept.txt b/_vale/config/vocabularies/Docker/accept.txt
index 8fde615fd509..01fff78eb353 100644
--- a/_vale/config/vocabularies/Docker/accept.txt
+++ b/_vale/config/vocabularies/Docker/accept.txt
@@ -157,7 +157,7 @@ S3
 scrollable
 SELinux
 Slack
-snapshotters?
+[sS]napshotters?
 Snyk
 Solr
 SonarQube

From 4408e5c0e055f6e0e0468ef74b3650b3ea35fa4b Mon Sep 17 00:00:00 2001
From: Arthur <arthur.flageul@docker.com>
Date: Wed, 30 Jul 2025 11:29:52 +0200
Subject: [PATCH 09/13] move icons ahead of category

---
 layouts/shortcodes/summary-bar.html | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/layouts/shortcodes/summary-bar.html b/layouts/shortcodes/summary-bar.html
index cf17a6f257e4..b694c484722a 100644
--- a/layouts/shortcodes/summary-bar.html
+++ b/layouts/shortcodes/summary-bar.html
@@ -32,7 +32,6 @@
       <div class="flex flex-wrap gap-1">
         <span class="font-bold">Subscription:</span>
         {{ range . }}
-          <span>{{ . }}</span>
           <span class="icon-svg">
             {{ $icon := index $subscriptionIcons . }}
             {{ if $icon }}
@@ -41,6 +40,7 @@
               {{ partial "icon" "default_icon" }}
             {{ end }}
           </span>
+          <span>{{ . }}</span>
         {{ end }}
       </div>
     {{ end }}
@@ -55,31 +55,37 @@
         {{ end }}
         <span class="font-bold">Availability:</span>
         <span>
-          {{ $availabilityText }}.
+          {{ $availabilityText }}
         </span>
-        <div> <span class="">{{ $text | markdownify }}</span></div>
+        <div>
+          <span>
+            {{- if $text -}}
+              . {{ $text | markdownify }}
+            {{- end -}}
+          </span>
+        </div>
       </div>
     {{ end }}
 
     {{ with $feature.requires }}
       <div class="flex flex-wrap gap-1">
-        <span class="font-bold">Requires:</span>
-        <span>{{ . | markdownify }}</span>
         <span class="icon-svg">
           {{ partial "icon" $requiresIcon }}
         </span>
+        <span class="font-bold">Requires:</span>
+        <span>{{ . | markdownify }}</span>
       </div>
     {{ end }}
 
     {{ with $feature.for }}
       <div class="flex flex-wrap gap-1">
-        <span class="font-bold">For:</span>
-        <span>{{ . }}</span>
         {{ if eq . "Administrators" }}
           <span class="icon-svg">
             {{ partial "icon" $forIcon }}
           </span>
         {{ end }}
+        <span class="font-bold">For:</span>
+        <span>{{ . }}</span>
       </div>
     {{ end }}
   </div>

From 59439dd0ba9428a2c465ea71caacf8090fde3e7a Mon Sep 17 00:00:00 2001
From: Arthur <arthur.flageul@docker.com>
Date: Wed, 30 Jul 2025 11:30:03 +0200
Subject: [PATCH 10/13] wip: content

---
 content/manuals/admin/company/owners.md       |  1 +
 content/manuals/engine/storage/_index.md      | 11 ++++
 content/manuals/engine/storage/containerd.md  | 54 +++++++++++++------
 .../manuals/engine/storage/drivers/_index.md  | 34 ++++++------
 .../manuals/engine/storage/snapshotters.md    | 25 +++++++++
 5 files changed, 92 insertions(+), 33 deletions(-)
 create mode 100644 content/manuals/engine/storage/snapshotters.md

diff --git a/content/manuals/admin/company/owners.md b/content/manuals/admin/company/owners.md
index c3afa9a65108..9079e50d4dd7 100644
--- a/content/manuals/admin/company/owners.md
+++ b/content/manuals/admin/company/owners.md
@@ -13,6 +13,7 @@ entire company and can manage settings that apply to all organizations under
 that company. They also have the same access rights as organization owners but
 don’t need to be members of any individual organization.
 
+
 > [!IMPORTANT]
 >
 > Company owners do not occupy a seat unless one of the following is true:
diff --git a/content/manuals/engine/storage/_index.md b/content/manuals/engine/storage/_index.md
index d616e3028672..9c8899791c72 100644
--- a/content/manuals/engine/storage/_index.md
+++ b/content/manuals/engine/storage/_index.md
@@ -18,6 +18,17 @@ container if another process needs it.
 The writable layer is unique per container. You can't easily extract the data
 from the writeable layer to the host, or to another container.
 
+> [!IMPORTANT]
+> Starting with Docker Engine v29, Docker uses
+> [containerd](./containerd.md) for managing container storage and images.
+
+## Image storage
+
+Docker offers two implementation of image storage:
+
+- Default/current implementation: [Containerd](./containerd.md)
+- Legacy/deprecated implementation: [Storage drivers](./drivers/_index.md)
+
 ## Storage mount options
 
 Docker supports the following types of storage mounts for storing data outside
diff --git a/content/manuals/engine/storage/containerd.md b/content/manuals/engine/storage/containerd.md
index 00ceed979dd8..c166d92d37c3 100644
--- a/content/manuals/engine/storage/containerd.md
+++ b/content/manuals/engine/storage/containerd.md
@@ -8,24 +8,47 @@ aliases:
   - /storage/containerd/
 ---
 
-{{< summary-bar feature_name="containerd" >}}
+Starting with Docker Engine v29, Docker uses [`containerd`](https://containerd.io/)
+for managing container storage and images. `containerd` is the industry-standard container runtime.
 
-containerd, the industry-standard container runtime, uses snapshotters instead
-of the classic storage drivers for storing image and container data.
-While the `overlay2` driver still remains the default driver for Docker Engine,
-you can opt in to using containerd snapshotters as an experimental feature.
+## Main benefits
 
-To learn more about the containerd image store and its benefits, refer to
+containerd offers the following benefits:
+
+- Shared maintenance: containerd is an open-source project maintained by a large community.
+- Customizability: use [snapshotters](snapshotters.md)
+  with unique characteristics, such as:
+  - [stargz](https://github.com/containerd/stargz-snapshotter) for lazy-pulling images on container
+  startup.
+  - [nydus](https://github.com/containerd/nydus-snapshotter) or [dragonfly](https://github.com/dragonflyoss/nydus) for peer-to-peer image distribution.
+- Portability: containerd is lighter and more modular.
+- Multi-platform support: Build multi-platform images and images with attestations.
+- WebAssembly: Ability to run Wasm containers.
+
+For more information about the containerd image store and its benefits, refer to
 [containerd image store on Docker Desktop](/manuals/desktop/features/containerd.md).
 
-## Enable containerd image store on Docker Engine
+## Migrate to containerd image store on Docker Engine
+
+When you update to Docker Engine v29 and enable the containrd feature, you are automatically migrated.
+This is a non-breaking migration with support for backward compatibility.
 
 Switching to containerd snapshotters causes you to temporarily lose images and
 containers created using the classic storage drivers.
 Those resources still exist on your filesystem, and you can retrieve them by
 turning off the containerd snapshotters feature.
 
-The following steps explain how to enable the containerd snapshotters feature.
+Docker Engine uses the `overlayfs` containerd snapshotter by default.
+
+To display which driver you are using, run:
+
+```console
+$ docker info -f '{{ .DriverStatus }}'
+```
+
+## Disabling containerd image store
+
+The following steps explain how to disable the containerd snapshotters feature.
 
 1. Add the following configuration to your `/etc/docker/daemon.json`
    configuration file:
@@ -33,24 +56,21 @@ The following steps explain how to enable the containerd snapshotters feature.
    ```json
    {
      "features": {
-       "containerd-snapshotter": true
+       "containerd-snapshotter": false
      }
    }
    ```
 
 2. Save the file.
+
 3. Restart the daemon for the changes to take effect.
 
    ```console
    $ sudo systemctl restart docker
    ```
 
-After restarting the daemon, running `docker info` shows that you're using
-containerd snapshotter storage drivers.
+4. Verify which driver you are using:
 
-```console
-$ docker info -f '{{ .DriverStatus }}'
-[[driver-type io.containerd.snapshotter.v1]]
-```
-
-Docker Engine uses the `overlayfs` containerd snapshotter by default.
+   ```console
+   $ docker info -f '{{ .DriverStatus }}'
+   ```
diff --git a/content/manuals/engine/storage/drivers/_index.md b/content/manuals/engine/storage/drivers/_index.md
index c6241730936c..af6c22f65b05 100644
--- a/content/manuals/engine/storage/drivers/_index.md
+++ b/content/manuals/engine/storage/drivers/_index.md
@@ -2,13 +2,15 @@
 description: Learn the technologies that support storage drivers.
 keywords: container, storage, driver, btrfs, overlayfs, vfs, zfs
 title: Storage drivers
-weight: 40
 aliases:
   - /storage/storagedriver/imagesandcontainers/
   - /storage/storagedriver/
   - /engine/userguide/storagedriver/imagesandcontainers/
 ---
 
+{{< summary-bar feature_name="StorageDrivers"
+text="Use [containerd](../containerd.md) instead.">}}
+
 To use storage drivers effectively, it's important to know how Docker builds and
 stores images, and how these images are used by containers. You can use this
 information to make informed choices about the best way to persist data from
@@ -170,7 +172,7 @@ docker.io/library/ubuntu:22.04
 
 Each of these layers is stored in its own directory inside the Docker host's
 local storage area. To examine the layers on the filesystem, list the contents
-of `/var/lib/docker/<storage-driver>`. This example uses the `overlay2` 
+of `/var/lib/docker/<storage-driver>`. This example uses the `overlay2`
 storage driver:
 
 ```console
@@ -326,7 +328,7 @@ layers are the same.
    Before BuildKit, the "classic" builder would produce a new "intermediate"
    image for each step for caching purposes, and the `IMAGE` column would show
    the ID of that image.
-   
+
    BuildKit uses its own caching mechanism, and no longer requires intermediate
    images for caching. Refer to [BuildKit](/manuals/build/buildkit/_index.md)
    to learn more about other enhancements made in BuildKit.
@@ -343,7 +345,7 @@ layers are the same.
      "sha256:07b4a9068b6af337e8b8f1f1dae3dd14185b2c0003a9a1f0a6fd2587495b204a"
    ]
    ```
-   
+
    ```console
    $ docker image inspect --format "{{json .RootFS.Layers}}" acme/my-final-image:1.0
    [
@@ -363,7 +365,7 @@ layers are the same.
    > [!TIP]
    >
    > Format output of Docker commands with the `--format` option.
-   > 
+   >
    > The examples above use the `docker image inspect` command with the `--format`
    > option to view the layer IDs, formatted as a JSON array. The `--format`
    > option on Docker commands can be a powerful feature that allows you to
@@ -412,7 +414,7 @@ in a `copy_up` operation, therefore duplicating the file to the writable layer.
 > applications, for example write-intensive databases, are known to be
 > problematic particularly when pre-existing data exists in the read-only
 > layer.
-> 
+>
 > Instead, use Docker volumes, which are independent of the running container,
 > and designed to be efficient for I/O. In addition, volumes can be shared
 > among containers and don't increase the size of your container's writable
@@ -449,7 +451,7 @@ examines how much room they take up.
 2. Run the `docker ps` command with the `--size` option to verify the 5 containers
    are running, and to see each container's size.
 
-   
+
    ```console
    $ docker ps --size --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Size}}"
 
@@ -460,35 +462,35 @@ examines how much room they take up.
    a5ff32e2b551   acme/my-final-image:1.0   my_container_2   0B (virtual 7.75MB)
    40ebdd763416   acme/my-final-image:1.0   my_container_1   0B (virtual 7.75MB)
    ```
-   
+
    The output above shows that all containers share the image's read-only layers
    (7.75MB), but no data was written to the container's filesystem, so no additional
    storage is used for the containers.
 
    {{< accordion title="Advanced: metadata and logs storage used for containers" >}}
-   
+
    > [!NOTE]
    >
    > This step requires a Linux machine, and doesn't work on Docker Desktop, as
    > it requires access to the Docker Daemon's file storage.
-   
+
    While the output of `docker ps` provides you information about disk space
    consumed by a container's writable layer, it doesn't include information
    about metadata and log-files stored for each container.
-   
+
    More details can be obtained by exploring the Docker Daemon's storage
    location (`/var/lib/docker` by default).
-   
+
    ```console
    $ sudo du -sh /var/lib/docker/containers/*
-   
+
    36K  /var/lib/docker/containers/3ed3c1a10430e09f253704116965b01ca920202d52f3bf381fbb833b8ae356bc
    36K  /var/lib/docker/containers/40ebdd7634162eb42bdb1ba76a395095527e9c0aa40348e6c325bd0aa289423c
    36K  /var/lib/docker/containers/939b3bf9e7ece24bcffec57d974c939da2bdcc6a5077b5459c897c1e2fa37a39
    36K  /var/lib/docker/containers/a5ff32e2b551168b9498870faf16c9cd0af820edf8a5c157f7b80da59d01a107
    36K  /var/lib/docker/containers/cddae31c314fbab3f7eabeb9b26733838187abc9a2ed53f97bd5b04cd7984a5a
    ```
-   
+
    Each of these containers only takes up 36k of space on the filesystem.
 
    {{< /accordion >}}
@@ -502,13 +504,13 @@ examines how much room they take up.
    ```console
    $ for i in {1..3}; do docker exec my_container_$i sh -c 'printf hello > /out.txt'; done
    ```
-   
+
    Running the `docker ps` command again afterward shows that those containers
    now consume 5 bytes each. This data is unique to each container, and not
    shared. The read-only layers of the containers aren't affected, and are still
    shared by all containers.
 
-   
+
    ```console
    $ docker ps --size --format "table {{.ID}}\t{{.Image}}\t{{.Names}}\t{{.Size}}"
 
diff --git a/content/manuals/engine/storage/snapshotters.md b/content/manuals/engine/storage/snapshotters.md
new file mode 100644
index 000000000000..aa480e7446f1
--- /dev/null
+++ b/content/manuals/engine/storage/snapshotters.md
@@ -0,0 +1,25 @@
+---
+title: containerd snapshotters
+description: Learn how to use containerd snapshotters in Docker Engine.
+keywords: containerd, snapshotters, storage, overlayfs, fuse, docker, engine, filesystem, performance
+---
+
+containerd snapshotters are components responsible for managing the filesystem
+layers of containers. They provide the mechanism for storing, mounting, and
+manipulating container filesystems using different backends such as overlayfs or
+fuse.
+
+By abstracting the storage implementation, snapshotters allow Docker Engine to
+efficiently manage container images and their writable layers, enabling features
+like fast image pulls, efficient storage usage, and support for advanced
+filesystems.
+
+For more information, see
+the [containerd repository](https://github.com/containerd/containerd/tree/main/docs/snapshotters).
+
+| Snapshotter           | Description                                                                            |
+|-----------------------|----------------------------------------------------------------------------------------|
+| `overlayfs` (default) | OverlayFS. The containerd implementation of the Docker/Moby `overlay2` storage driver. |
+| `native`              | Native file copying driver. Akin to Docker/Moby's "vfs" driver.                        |
+
+

From ab4d2414b798afbf401340dcc9dc9c8752873399 Mon Sep 17 00:00:00 2001
From: Arthur <arthur.flageul@docker.com>
Date: Mon, 11 Aug 2025 14:58:52 +0200
Subject: [PATCH 11/13] touch up

---
 content/manuals/engine/storage/containerd.md | 12 +++++++-----
 hugo_stats.json                              |  4 ----
 2 files changed, 7 insertions(+), 9 deletions(-)

diff --git a/content/manuals/engine/storage/containerd.md b/content/manuals/engine/storage/containerd.md
index c166d92d37c3..f437ad9ac4ee 100644
--- a/content/manuals/engine/storage/containerd.md
+++ b/content/manuals/engine/storage/containerd.md
@@ -30,13 +30,15 @@ For more information about the containerd image store and its benefits, refer to
 
 ## Migrate to containerd image store on Docker Engine
 
-When you update to Docker Engine v29 and enable the containrd feature, you are automatically migrated.
-This is a non-breaking migration with support for backward compatibility.
+When you update to Docker Engine v29 and enable the containrd feature, you are
+automatically migrated. The migration mechanism handles overlay and vfs images.
 
 Switching to containerd snapshotters causes you to temporarily lose images and
-containers created using the classic storage drivers.
-Those resources still exist on your filesystem, and you can retrieve them by
-turning off the containerd snapshotters feature.
+containers created using the classic storage drivers. If you use other graph storage, repull or rebuild your images.
+
+> [!TIP]
+> Those resources still exist on your filesystem, and you can retrieve them by
+> turning off the containerd snapshotters feature.
 
 Docker Engine uses the `overlayfs` containerd snapshotter by default.
 
diff --git a/hugo_stats.json b/hugo_stats.json
index 7e45d1ea47e9..be88f4ad5b76 100644
--- a/hugo_stats.json
+++ b/hugo_stats.json
@@ -2,7 +2,6 @@
   "htmlElements": {
     "tags": null,
     "classes": [
-      "$availabilityText",
       "--mount",
       "--tmpfs",
       "-mt-8",
@@ -35,7 +34,6 @@
       "DNS-resolution",
       "Debian",
       "Debian-GNU/Linux",
-      "Deprecated",
       "Diff",
       "Docker-Build-Cloud",
       "Docker-Desktop",
@@ -543,7 +541,6 @@
       "tab-item",
       "tablist",
       "tabs",
-      "text",
       "text-2xl",
       "text-base",
       "text-black",
@@ -586,7 +583,6 @@
       "w-[500px]",
       "w-full",
       "w-screen",
-      "whitespace-normal",
       "whitespace-nowrap",
       "xl:flex",
       "xl:flex-row",

From cfa87ec4ef2cfafb84c37508e50e71cf96a3dd4d Mon Sep 17 00:00:00 2001
From: Arthur <arthur.flageul@docker.com>
Date: Wed, 13 Aug 2025 09:53:57 +0200
Subject: [PATCH 12/13] vale

---
 _vale/config/vocabularies/Docker/accept.txt  | 3 ++-
 content/manuals/engine/storage/containerd.md | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/_vale/config/vocabularies/Docker/accept.txt b/_vale/config/vocabularies/Docker/accept.txt
index 01fff78eb353..412c1dd0472f 100644
--- a/_vale/config/vocabularies/Docker/accept.txt
+++ b/_vale/config/vocabularies/Docker/accept.txt
@@ -149,6 +149,7 @@ Qualcomm
 Quickview
 rebalance
 reimplement
+repull
 rollback
 rootful
 runc
@@ -157,7 +158,6 @@ S3
 scrollable
 SELinux
 Slack
-[sS]napshotters?
 Snyk
 Solr
 SonarQube
@@ -239,6 +239,7 @@ Zsh
 [Rr]untimes?
 [Ss]andbox(ed)?
 [Ss]eccomp
+[sS]napshotters?
 [Ss]ubmounts?
 [Ss]ubnet
 [Ss]ubpaths?
diff --git a/content/manuals/engine/storage/containerd.md b/content/manuals/engine/storage/containerd.md
index f437ad9ac4ee..bfb18924ea0a 100644
--- a/content/manuals/engine/storage/containerd.md
+++ b/content/manuals/engine/storage/containerd.md
@@ -30,7 +30,7 @@ For more information about the containerd image store and its benefits, refer to
 
 ## Migrate to containerd image store on Docker Engine
 
-When you update to Docker Engine v29 and enable the containrd feature, you are
+When you update to Docker Engine v29 and enable the containerd feature, you are
 automatically migrated. The migration mechanism handles overlay and vfs images.
 
 Switching to containerd snapshotters causes you to temporarily lose images and

From 96b7f5abadec180abdbd5fbf58c36114b4785717 Mon Sep 17 00:00:00 2001
From: Arthur <arthur.flageul@docker.com>
Date: Wed, 13 Aug 2025 11:03:14 +0200
Subject: [PATCH 13/13] hugo stats

---
 hugo_stats.json | 1 -
 1 file changed, 1 deletion(-)

diff --git a/hugo_stats.json b/hugo_stats.json
index be88f4ad5b76..c166c5aca8fa 100644
--- a/hugo_stats.json
+++ b/hugo_stats.json
@@ -582,7 +582,6 @@
       "w-[1200px]",
       "w-[500px]",
       "w-full",
-      "w-screen",
       "whitespace-nowrap",
       "xl:flex",
       "xl:flex-row",