From 047c27aaf4bdefe5902bc7064fe8a5c17d48850a Mon Sep 17 00:00:00 2001
From: Daishi Kato <dai-shi@users.noreply.github.com>
Date: Tue, 31 Oct 2023 23:17:16 +0900
Subject: [PATCH] docs: add a warning for selectAtom (#2210)

* docs: add a warning for selectAtom

* run prettier
---
 docs/utilities/select.mdx | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/utilities/select.mdx b/docs/utilities/select.mdx
index 90d776aca7..e026a94f1b 100644
--- a/docs/utilities/select.mdx
+++ b/docs/utilities/select.mdx
@@ -7,7 +7,9 @@ published: false
 
 ## selectAtom
 
-Ref: https://github.com/pmndrs/jotai/issues/36
+⚠️ Unlike its name, `selectAtom` is provided as an escape hatch. Using it means building not 100% pure atom model. Prefer using derived atoms and use `selectAtom` only when `equalityFn` or `prevSlice` is unavoidable.
+
+### Signatures
 
 ```ts
 function selectAtom<Value, Slice>(