diff --git a/dev/breeze/doc/03_developer_tasks.rst b/dev/breeze/doc/03_developer_tasks.rst index a630b6c2f3fdc..8083a40b23edd 100644 --- a/dev/breeze/doc/03_developer_tasks.rst +++ b/dev/breeze/doc/03_developer_tasks.rst @@ -809,6 +809,12 @@ Discovery includes volumes and networks even when no containers remain. Resource directly through Docker, so deleted worktrees do not need their Compose files restored. ``--preserve-volumes`` keeps named and anonymous volumes, including those from deleted worktrees. Shared MyPy and bytecode caches remain controlled by their explicit cleanup flags. +``down`` keeps the build cache volume of each project (``/root/.cache`` in the container) until +``--cleanup-build-cache`` is passed, which also works together with ``--preserve-volumes``. +Without ``--preserve-volumes``, build cache volumes of deleted worktrees are removed without the flag. +``breeze doctor`` removes them only when you confirm the cache removal. Other commands that bring +a project down, such as ``breeze shell --restart``, still remove its build cache volume with the +other volumes. Unlike ``breeze cleanup``, ``down`` does not delete local source files, environments, images, or build caches unless an explicit cache-cleanup flag is passed. diff --git a/dev/breeze/doc/images/output-commands.svg b/dev/breeze/doc/images/output-commands.svg index 93c54b8a97cc4..1eb94402a776a 100644 --- a/dev/breeze/doc/images/output-commands.svg +++ b/dev/breeze/doc/images/output-commands.svg @@ -1,4 +1,4 @@ - +