Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

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

Aperta Adatta ai principianti
#26,164 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
1/5
Tempo stimato
Meno di un'ora
Idoneità per principianti
85/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
markdown
Ambito
documentation

Direzione di ricerca

L'issue punta al file content/manuals/engine/storage/drivers/select-storage-driver.md. Leggere il file per comprendere la sezione 'Supported storage drivers per Linux distribution'. La correzione comporta la modifica dell'intestazione e l'aggiunta di una nota più chiara sullo stato legacy. Controllare la documentazione di containerd collegata per il contesto. Dopo la modifica, verificare che le modifiche vengano visualizzate correttamente nell'anteprima del sito di documentazione.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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

Lingua principale
Markdown
Stelle
4.7k
Fork
8.5k
Merge medio
2g 16h
PR unite (30g)
116

Guida per i contributori

Apri la guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di docker/docs

Tutte le issue di docker/docs

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.