diff --git a/src/ipc.ts b/src/ipc.ts
index 2f396db310..ea4a8b5b42 100644
--- a/src/ipc.ts
+++ b/src/ipc.ts
@@ -21,6 +21,9 @@ ipcMain.on(
             // each other. See https://github.com/vector-im/element-web/issues/16942
             app.badgeCount = count;
         } else {
+            // similarly, we only use setOverlayIcon on Windows as it's only supported on that platform, but has good support
+            // from all the Windows variants we support.
+            // https://www.electronjs.org/docs/latest/api/browser-window#winsetoverlayiconoverlay-description-windows
             if (imageBuffer && imageBufferDescription !== undefined) {
                 global.mainWindow?.setOverlayIcon(
                     nativeImage.createFromBuffer(Buffer.from(imageBuffer)),