diff --git a/kwin/decorations/CMakeLists.txt b/kwin/decorations/CMakeLists.txt
index 164cbc27..3d24a8c3 100644
--- a/kwin/decorations/CMakeLists.txt
+++ b/kwin/decorations/CMakeLists.txt
@@ -1,6 +1,5 @@
-# SPDX-FileCopyrightText: 2025 SHIFT Contributors
-# SPDX-License-Identifier: GPL-2.0-or-later
-
+# SPDX-FileCopyrightText: 2026 Marco Allegretti <
+# SPDX-License-Identifier: EUPL-1.2
 install(
     DIRECTORY org.shift.decoration
     DESTINATION ${KDE_INSTALL_DATADIR}/kwin/decorations
diff --git a/kwin/decorations/org.shift.decoration/contents/ui/main.qml b/kwin/decorations/org.shift.decoration/contents/ui/main.qml
index c26a6c6e..bf9561d8 100644
--- a/kwin/decorations/org.shift.decoration/contents/ui/main.qml
+++ b/kwin/decorations/org.shift.decoration/contents/ui/main.qml
@@ -1,5 +1,5 @@
-// SPDX-FileCopyrightText: 2025 SHIFT Contributors
-// SPDX-License-Identifier: GPL-2.0-or-later
+// SPDX-FileCopyrightText: 2026 Marco Allegretti
+// SPDX-License-Identifier: EUPL 1.2
 
 import QtQuick
 import org.kde.kwin.decoration
@@ -181,6 +181,11 @@ Decoration {
             }
         }
 
+        // Snap-assist hover trigger lives in the shift-tiling KWin script:
+        // the decoration QML sandbox has no DBus / kglobalaccel access, so
+        // the script polls the cursor over the active window's titlebar
+        // and invokes the SHIFT Snap Assist shortcut after a short hover.
+
         Rectangle {
             visible: !isSpacer
             anchors.fill: parent