diff --git a/doc/upgrade-react18.md b/doc/upgrade-react18.md
new file mode 100644
index 000000000..0c9ff0f68
--- /dev/null
+++ b/doc/upgrade-react18.md
@@ -0,0 +1,10 @@
+* [x] `startTransition`
+* [x] `useDeferredValue`
+* [x] `useId`
+* [x] `useInsertionEffect`
+* [x] `useSyncExternalStore`
+* [x] `useTransition`
+* [x] `react-dom/client`: `createRoot`
+* [x] `react-dom/client`: `hydrateRoot`
+* [ ] `react-dom/server`: `renderToPipeableStream`
+* [ ] `react-dom/server`: `renderToReadableStream`