Skip to content

Fix issue #24435: clarify volume description in bind mounts#24441

Open
dvdksn wants to merge 2 commits intomainfrom
fix/issue-24435-clarify-volume-desc
Open

Fix issue #24435: clarify volume description in bind mounts#24441
dvdksn wants to merge 2 commits intomainfrom
fix/issue-24435-clarify-volume-desc

Conversation

@dvdksn
Copy link
Contributor

@dvdksn dvdksn commented Mar 20, 2026

Clarifies the volume description in the bind mounts documentation to avoid confusion about Docker's role in managing volume contents.

Changes:

  • Revised the introductory paragraph to clarify that Docker creates and maintains the storage location, but containers access it directly using standard filesystem operations
  • Removes language that could be misinterpreted as Docker actively copying or syncing data

Fixes #24435

@netlify
Copy link

netlify bot commented Mar 20, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 4480765
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/69bd3c455202fc0007fb3e59
😎 Deploy Preview https://deploy-preview-24441--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 dependencies Vendoring, packaging updates labels Mar 20, 2026
Copy link
Contributor

@docker-agent docker-agent bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Assessment: 🟢 APPROVE

This PR successfully clarifies the volume description in the bind mounts documentation. The changes are well-crafted and improve clarity without introducing any documentation quality issues.

What was reviewed:

  • ✅ No vendored content edited
  • ✅ No redirects needed (no pages removed/moved)
  • ✅ Markdown formatting is correct
  • ✅ No AI-isms or hedge words
  • ✅ Scope preserved (minimal, focused change)
  • ✅ Content is factually accurate
  • ✅ Front matter unchanged and valid

Key improvement:
The revised text clarifies that Docker creates and maintains the storage location for volumes, but containers access it directly using standard filesystem operations. This removes potential confusion about Docker "managing" the directory's contents in an active sense.

The package-lock.json changes are routine dependency updates with no documentation impact.

No issues found. This change improves documentation clarity and accuracy.

@dvdksn dvdksn requested a review from a team March 20, 2026 11:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agent/generated area/engine Issue affects Docker engine/daemon area/storage Relates to storage, volumes dependencies Vendoring, packaging updates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Intro description of a volume does not appear to align with later text

1 participant