diff --git a/packages/docs/src/routes/docs/components/index.mdx b/packages/docs/src/routes/docs/components/index.mdx
index c887fffa6a..732a1064c8 100644
--- a/packages/docs/src/routes/docs/components/index.mdx
+++ b/packages/docs/src/routes/docs/components/index.mdx
@@ -276,6 +276,14 @@ export default function MyComponent(props) {
 
 </details>
 
+> **Note**: You cannot directly iterate over the children prop. It is a special property intended for rendering like this:
+
+```jsx
+<div>{props.children}</div>
+````
+
+Many frameworks do not support manipulating or iterating over it directly, unlike frameworks such as React or Vue.
+
 ### Slot
 
 When you want to register a named slot you do so using a prop.