Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto Apto para principiantes
#26,164 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
85/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
markdown

Línea de trabajo

El issue apunta al archivo content/manuals/engine/storage/drivers/select-storage-driver.md. Lea el archivo para comprender la sección 'Supported storage drivers per Linux distribution'. La corrección implica editar el encabezado y agregar una nota más clara sobre el estado de legacy. Consulte la documentación de containerd vinculada para obtener contexto. Después de editar, verifique que los cambios se representen correctamente en la vista previa del sitio de documentación.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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

Lenguaje dominante
Markdown
Estrellas
4.7k
Forks
8.5k
Merge medio
2 d 16 h
PR fusionados (30 d)
116

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de docker/docs

Todos los issues de docker/docs

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.