From a1a371b5880d1c251560d28ae742f9ce480af237 Mon Sep 17 00:00:00 2001
From: Zach <zach@zachsims.com>
Date: Sun, 5 Nov 2023 01:17:53 -0500
Subject: [PATCH 1/2] Update refs.md

Added details on $refs not supporting dynamic binding anymore in V3
---
 packages/docs/src/en/magics/refs.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/packages/docs/src/en/magics/refs.md b/packages/docs/src/en/magics/refs.md
index 6c42f5e2d..f8ccd37b0 100644
--- a/packages/docs/src/en/magics/refs.md
+++ b/packages/docs/src/en/magics/refs.md
@@ -25,3 +25,19 @@ title: refs
 <!-- END_VERBATIM -->
 
 Now, when the `<button>` is pressed, the `<span>` will be removed.
+
+<a name="limitations"></a>
+### Limitations
+
+In V2 it was possible to bind `$refs` to elements dynamically, like seen below:
+
+```alpine
+<template x-for="item in items" :key="item.id" >
+    <div :x-ref="item.name">
+    some content ...
+    </div>
+</template>
+```
+
+However, in Alpine V3 you can only access `$refs` for elements created statically. For the example above, the `$refs` would not contain `item.name`.
+

From 0e3f2b5ff50991b1483f17043cb31e2e4a2f6c02 Mon Sep 17 00:00:00 2001
From: Zach <zach@zachsims.com>
Date: Sun, 5 Nov 2023 01:45:30 -0500
Subject: [PATCH 2/2] Update refs.md

Fixed logic of the example to reflect the actual evaluation of $refs
---
 packages/docs/src/en/magics/refs.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/docs/src/en/magics/refs.md b/packages/docs/src/en/magics/refs.md
index f8ccd37b0..acfc2446e 100644
--- a/packages/docs/src/en/magics/refs.md
+++ b/packages/docs/src/en/magics/refs.md
@@ -39,5 +39,4 @@ In V2 it was possible to bind `$refs` to elements dynamically, like seen below:
 </template>
 ```
 
-However, in Alpine V3 you can only access `$refs` for elements created statically. For the example above, the `$refs` would not contain `item.name`.
-
+However, in V3, `$refs` can only be accessed for elements that are created statically. So for the example above: if you were expecting the value of `item.name` inside of `$refs` to be something like *Batteries*, you should be aware that `$refs` will actually contain the literal string `'item.name'` and not *Batteries*.