Skip to content

[docs-scanner] Deprecated storage drivers still presented as current options #26164

Description

@docker-agent

File: content/manuals/engine/storage/drivers/select-storage-driver.md

Issue

The "Supported storage drivers per Linux distribution" section presents overlay2 as the "Default classic driver" for all listed distributions, but the page's own introduction states:

Docker Engine 29.0 and later uses the containerd image store by default for fresh installations.

The table then says:

This section applies to classic storage drivers only. If you're using the containerd image store (the default for Docker Engine 29.0+), see the containerd image store documentation instead.

However, the table is still positioned prominently as if it represents current defaults, when in reality these are legacy configurations. The framing "Default classic driver" is confusing because it suggests these are still the defaults, when they're only defaults if you're using the deprecated classic storage system.

Why this matters

A reader installing Docker Engine 29.0+ will see this table and may incorrectly believe that overlay2 is what their system is using by default. The table doesn't make it clear enough that this entire section is about a legacy system that most new users won't be using.

Suggested fix

Restructure the section to make the legacy status clearer. Consider:

  1. Move the "This section applies to classic storage drivers only" note to the top of the section, before the table
  2. Change the heading from "Supported storage drivers per Linux distribution" to "Supported classic storage drivers per Linux distribution (legacy)"
  3. Reframe the table introduction to explicitly state: "For systems using classic storage drivers (not the default for Docker Engine 29.0+), the following configurations are supported:"

Found by nightly documentation quality scanner

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions