[docs-scanner] Deprecated storage drivers still presented as current options
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
- Área
- documentation
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:
- Move the "This section applies to classic storage drivers only" note to the top of the section, before the table
- Change the heading from "Supported storage drivers per Linux distribution" to "Supported classic storage drivers per Linux distribution (legacy)"
- 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
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de docker/docs
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 95/100
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 95/100
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 92/100
Todos los issues de docker/docs
Issues similares
-
Link Checker Report Abiertoautomated issue report
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
-
Humanity AI Abierto
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
numfocus/project-fundraising#166 ·
-
area:proxy bug security severity:low track:open-source
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100