Skip to content

docs(storage): scope overlay2 driver page to classic storage driver - #26166

Open
jaideepkrishna2008-ui wants to merge 1 commit into
docker:mainfrom
jaideepkrishna2008-ui:fix/storage-driver-default-guidance-26163
Open

jaideepkrishna2008-ui wants to merge 1 commit into
docker:mainfrom
jaideepkrishna2008-ui:fix/storage-driver-default-guidance-26163

Conversation

@jaideepkrishna2008-ui

@jaideepkrishna2008-ui jaideepkrishna2008-ui commented Sep 23, 2026 •

Copy link
Copy Markdown

Description

Update the scope note on the OverlayFS storage driver page (overlayfs-driver.md) to clarify that this page covers the classic overlay2 storage driver, and point users to the containerd image store for the overlayfs snapshotter.

Reverts the redundant 'for fresh installations' additions on select-storage-driver.md, keeping the existing explanation intact as requested in maintainer review.

Related issues or tickets

Fixes #26163

Reviews

  • Technical review
  • Editorial review
  • Product review

@netlify

netlify Bot commented Sep 23, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 9c41889
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6ab9eb924d9c5e00082c9f69
😎 Deploy Preview https://deploy-preview-26166--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added area/engine Issue affects Docker engine/daemon area/storage Relates to storage, volumes labels Sep 23, 2026
@dvdksn

dvdksn commented Sep 27, 2026

Copy link
Copy Markdown
Contributor

Please rewrite this around the reader's storage configuration rather than adding "for fresh installations" to each mention of the default. The selection page already explains installation and upgrade behavior at the top; the extra table qualification and parenthesis repeat that explanation awkwardly. Revert those additions. On the OverlayFS page, use a scope note: "This page covers the classic overlay2 storage driver. For the overlayfs snapshotter used by the containerd image store, see containerd image store." The linked page already explains defaults and migration.

Generated by Codex

Update the scope note on the OverlayFS storage driver page to clarify that
it covers the classic overlay2 driver, and link to containerd image store
for the overlayfs snapshotter.

Fixes docker#26163

Signed-off-by: jaideepkrishna <jaideepkrishna2008@gmail.com>
@jaideepkrishna2008-ui
jaideepkrishna2008-ui force-pushed the fix/storage-driver-default-guidance-26163 branch from 550521e to 9c41889 Compare September 28, 2026 04:22
@jaideepkrishna2008-ui jaideepkrishna2008-ui changed the title docs: standardize Docker Engine 29.0 containerd default storage guidance docs(storage): scope overlay2 driver page to classic storage driver Sep 28, 2026
@jaideepkrishna2008-ui

Copy link
Copy Markdown
Author

Thanks for the review and clear guidance @dvdksn!

I've updated the PR accordingly:

  • Reverted the changes on select-storage-driver.md to keep the existing selection and upgrade explanation clean.
  • Updated overlayfs-driver.md with the requested scope note pointing readers to the containerd image store for the overlayfs snapshotter.

Ready for another look!

This branch has not been deployed

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

Labels

area/engine Issue affects Docker engine/daemon area/storage Relates to storage, volumes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[docs-scanner] Contradictory information about Docker Engine 29.0 default storage

2 participants