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 <[email protected]>
@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.

@dvdksn dvdksn requested a review from a team March 24, 2026 16:32
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 status/review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add builder to pruning?

1 participant