Skip to content

docs: add docker builder prune to pruning page#24429

Open
dvdksn wants to merge 1 commit intodocker:mainfrom
dvdksn:fix/issue-17590-builder-prune
Open

docs: add docker builder prune to pruning page#24429
dvdksn wants to merge 1 commit intodocker:mainfrom
dvdksn:fix/issue-17590-builder-prune

Conversation

@dvdksn
Copy link
Contributor

@dvdksn dvdksn commented Mar 19, 2026

Summary

Fixes #17590.

The pruning documentation page was missing coverage of docker builder prune. This PR adds a new Prune build cache section before the existing "Prune everything" section, following the same style as the other sections on the page.

Changes:

  • Explains what build cache is and how docker builder prune removes dangling build cache
  • Shows the basic docker builder prune command with its confirmation prompt
  • Documents the --all flag for removing all build cache, not just dangling entries
  • Links to the docker builder prune CLI reference

Test plan

  • Verify the new section renders correctly on the docs site
  • Confirm the link to /reference/cli/docker/builder/prune/ resolves correctly

🤖 Generated with Claude Code

Fixes docker#17590. Adds a new "Prune build cache" section covering
docker builder prune, including the --all flag for removing all
build cache (not just dangling entries).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@netlify
Copy link

netlify bot commented Mar 19, 2026

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 4b2c513
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/69bc1e730b4555000809f5ad
😎 Deploy Preview https://deploy-preview-24429--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 the area/engine Issue affects Docker engine/daemon label Mar 19, 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 adds comprehensive documentation for docker builder prune to the pruning page. The new section follows the established pattern of other prune sections and is well-structured.

Review Summary:

  • ✅ No vendored content edited
  • ✅ No missing redirects (no pages removed/moved)
  • ✅ Markdown formatting is correct
  • ✅ No AI-isms or style guide violations in new content
  • ✅ Scope preservation maintained (matches existing sections)
  • ✅ Content accuracy verified (commands are correct)
  • ✅ CLI reference link is valid
  • ✅ Consistent with existing documentation patterns

The new "Prune build cache" section clearly explains:

  • What build cache is and why it grows
  • How to remove dangling build cache
  • How to remove all build cache with --all
  • Links to the CLI reference for more details

No issues found in the changed code.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add builder to pruning?

1 participant