From e119bc16434905494baab4ca3957d279262d27d1 Mon Sep 17 00:00:00 2001
From: Ben Grande <ben@invisiblethingslab.com>
Date: Wed, 3 Dec 2025 13:09:03 +0100
Subject: [PATCH] Note preload autostart refills instead of refresh

For: https://github.com/QubesOS/qubes-core-admin/pull/758
For: https://github.com/QubesOS/qubes-issues/issues/1512
---
 .../services/disposablevm-implementation.rst    | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/developer/services/disposablevm-implementation.rst b/developer/services/disposablevm-implementation.rst
index d5d9bd713..2451f633f 100644
--- a/developer/services/disposablevm-implementation.rst
+++ b/developer/services/disposablevm-implementation.rst
@@ -66,13 +66,16 @@ Preloaded disposable's management
 
 These are common events that trigger changes in preloaded disposables quantity:
 
-- Setting or deleting the ``preload-dispvm-max`` feature will refill or remove;
-- (Re)starting :file:`qubes-preload-dispvm.service` will refresh;
-- Using a preloaded disposable will refill;
-- Requesting a disposable will refill;
-- Updating the volumes of a template or disposable template will refresh;
-- Changing system's :py:attr:`default_dispvm <core-admin:qubes.vm.dispvm.DispVM.default_dispvm>` while system's feature is set to a different value than the disposable template setting will refill or remove; and
-- Qubesd was interrupted mid preload creation, on the next service restart, :py:meth:`domain-load <core-admin:qubes.vm.mix.dvmtemplate.DVMTemplateMixin.on_domain_loaded>` of the disposable template will refresh the incomplete disposables.
+- Refill or remove:
+  - Changing the ``preload-dispvm-max`` feature;
+  - Changing system's :py:attr:`default_dispvm <core-admin:qubes.vm.dispvm.DispVM.default_dispvm>` while system's feature is set to a different value than the disposable template setting;
+- Refill:
+  - (Re)starting :file:`qubes-preload-dispvm.service`;
+  - Using a preloaded disposable;
+  - Requesting a disposable;
+- Refresh:
+  - Updating the volumes of a template or disposable template;
+  - Qubesd was interrupted mid preload creation, on the next service restart, :py:meth:`domain-load <core-admin:qubes.vm.mix.dvmtemplate.DVMTemplateMixin.on_domain_loaded>` of the disposable template.
 
 Preloaded disposable's temporary gaps
 """""""""""""""""""""""""""""""""""""