diff --git a/src/vector/app.js b/src/vector/app.js
index 00699dc527..8ade17d817 100644
--- a/src/vector/app.js
+++ b/src/vector/app.js
@@ -162,6 +162,8 @@ function onTokenLoginCompleted() {
 }
 
 export async function loadApp() {
+    // XXX: the way we pass the path to the worker script from webpack via html in body's dataset is a hack
+    // but alternatives seem to require changing the interface to passing Workers to js-sdk
     const vectorIndexeddbWorkerScript = document.body.dataset.vectorIndexeddbWorkerScript;
     if (!vectorIndexeddbWorkerScript) {
         // If this is missing, something has probably gone wrong with