diff --git a/rspack.config.js b/rspack.config.js
index c8dd12f912..bfb456e897 100644
--- a/rspack.config.js
+++ b/rspack.config.js
@@ -3,6 +3,11 @@ const { VueLoaderPlugin } = require("vue-loader");
 const path = require("path");
 const rspack = require("@rspack/core");
 
+// NOTE: Every output.path under koha-tmpl/ that ships must also be handled in
+// Makefile.PL: the 'NONE' entries in the target-directory map and the cp -r
+// lines in the compile step. A new dist dir added here without both changes is
+// silently omitted from packaged builds (see Bug 43401).
+
 const islandsExport = application => {
     const vueDir =
         application === "intranet"