update

Author: LadyBluenotes

src/routes/reference/rendering/hydrate.mdx

@@ -58,13 +58,13 @@ DOM node that contains the server-rendered markup.
 
 - **Type:** `string`
 
-Hydration render identifier.
+Scopes hydration lookup to a specific rendered subtree.
 
 #### `owner`
 
 - **Type:** `unknown`
 
-Owner used for the hydration root.
+Owner used for the created hydration root.
 
 ## Return value
 
@@ -74,8 +74,8 @@ Dispose function for the hydrated root.
 
 ## Behavior
 
-- `hydrate` reuses existing DOM instead of creating a new subtree.
-- The target node is expected to contain server-rendered markup that matches the rendered output.
+- `hydrate` is a client-only API and throws in the server bundle.
+- `hydrate` reuses server-rendered DOM instead of creating a new subtree, locating nodes through Solid's hydration markers and optionally scoping that lookup with `renderId`.
 - The returned function disposes the hydrated root.
 
 ## Examples
@@ -85,6 +85,7 @@ Dispose function for the hydrated root.
 ```ts
 import { hydrate } from "solid-js/web";
 
+// #app already contains server-rendered Solid markup
 const dispose = hydrate(() => <App />, document.getElementById("app")!);
 ```