From 88b3a1c98a3f291c62fba7f994a52b8dd97c9f4a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Julien=20Valverd=C3=A9?= <julien.valverde@mailo.com>
Date: Tue, 9 Jun 2026 10:48:46 +0200
Subject: [PATCH] Docs

---
 packages/docs/docs/getting-started.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/packages/docs/docs/getting-started.md b/packages/docs/docs/getting-started.md
index 574adb5..98b84d3 100644
--- a/packages/docs/docs/getting-started.md
+++ b/packages/docs/docs/getting-started.md
@@ -89,6 +89,11 @@ Use `Component.make` when you want automatic tracing spans, or
 `Component.makeUntraced` when you only want the component behavior. This creates
 an Effect-FC component, not a plain React component yet.
 
+The Effect run during render must be synchronous. Effect-FC follows React's
+render model, so component bodies should produce JSX without waiting on async
+work. Use lifecycle hooks, callbacks, queries, or other Effect-FC helpers for
+async work that happens outside render.
+
 ```tsx title="src/HelloView.tsx"
 import { Effect } from "effect"
 import { Component } from "effect-fc"