diff --git a/src/language-toggle.js b/src/language-toggle.js
index e22c26447c..202fa7733a 100644
--- a/src/language-toggle.js
+++ b/src/language-toggle.js
@@ -8,7 +8,8 @@
  *
  * How it works:
  * 1. Click listener detects language toggle clicks and stores current URL+hash
- * 2. MutationObserver detects when Mintlify's client-side routing changes the path
+ * 2. History API interception (pushState/replaceState) and popstate/hashchange
+ *    listeners detect when Mintlify's client-side routing changes the path
  * 3. On path change, check if we're switching languages and redirect to equivalent page
  */