diff --git a/docs/installation/alpine.md b/docs/installation/alpine.md
index 439e9e06b95..365e8d42fe6 100644
--- a/docs/installation/alpine.md
+++ b/docs/installation/alpine.md
@@ -48,7 +48,7 @@ import StarterKit from '@tiptap/starter-kit'
 
 document.addEventListener('alpine:init', () => {
   Alpine.data('editor', (content) => {
-    let editor
+    let editor // Alpine's reactive engine automatically wraps component properties in proxy objects. Attempting to use a proxied editor instance to apply a transaction will cause a "Range Error: Applying a mismatched transaction", so be sure to unwrap it using Alpine.raw(), or simply avoid storing your editor as a component property, as shown in this example.
 
     return {
       updatedAt: Date.now(), // force Alpine to rerender on selection change