[docs-scanner] Deprecated storage drivers still presented as current options
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:
- 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
- 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
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di docker/docs
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 90/100
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 95/100
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 95/100
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 92/100
Issue simili
-
Area: Excel support
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
orbeon/orbeon-forms#7893 ·
-
Theme loads third-party resources on every page (jsdelivr web font, cdnjs Font Awesome) – GDPR Aperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 75/100
docToolchain/docToolchain#1705 ·
-
kb-infra-drift
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
OCHA-DAP/ds-knowledge-base#653 · 1 commento ·
-
area/dev-productivity area/disaster-recovery area/ipcei kind/enhancement
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
-
Claiming namespace: rasy007 Apertanamespace operations
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 90/100
EclipseFdn/open-vsx.org#13419 ·