From aed5ec3e2f6fb10e636a9e7d4bb1f96f66493406 Mon Sep 17 00:00:00 2001
From: Andras Bacsai <5845193+andrasbacsai@users.noreply.github.com>
Date: Sat, 15 Aug 2026 17:59:32 +0200
Subject: [PATCH] docs(ui): clarify application image retention cleanup options

---
 resources/views/livewire/server/docker-cleanup.blade.php | 2 +-
 tests/Feature/DockerCleanupExecutionStyleTest.php        | 8 ++++++++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/resources/views/livewire/server/docker-cleanup.blade.php b/resources/views/livewire/server/docker-cleanup.blade.php
index b09c67909..d50ead819 100644
--- a/resources/views/livewire/server/docker-cleanup.blade.php
+++ b/resources/views/livewire/server/docker-cleanup.blade.php
@@ -99,7 +99,7 @@
                                 ['value' => true, 'label' => 'Delete unused networks'],
                             ]" />
                         <x-forms.listbox id="disableApplicationImageRetention" label="Application images"
-                            helper="Keeping retained images allows application rollbacks."
+                            helper="Choose Keep retained images to follow each application’s Images to keep setting under Rollback. Delete all old images ignores that setting and keeps only the running image."
                             onChange="instantSave" :options="[
                                 ['value' => false, 'label' => 'Keep retained images'],
                                 ['value' => true, 'label' => 'Delete all old images'],
diff --git a/tests/Feature/DockerCleanupExecutionStyleTest.php b/tests/Feature/DockerCleanupExecutionStyleTest.php
index bad31d2d1..e220c8bc3 100644
--- a/tests/Feature/DockerCleanupExecutionStyleTest.php
+++ b/tests/Feature/DockerCleanupExecutionStyleTest.php
@@ -17,3 +17,11 @@ test('docker cleanup executions show a loading state while opening an execution'
         ->toContain('wire:loading.remove')
         ->toContain('<x-loading wire:loading');
 });
+
+test('docker cleanup explains application image retention options', function () {
+    $view = file_get_contents(resource_path('views/livewire/server/docker-cleanup.blade.php'));
+
+    expect($view)
+        ->toContain('Choose Keep retained images to follow each application’s Images to keep setting under Rollback.')
+        ->toContain('Delete all old images ignores that setting and keeps only the running image.');
+});