diff --git a/.changeset/curly-kangaroos-clap.md b/.changeset/curly-kangaroos-clap.md
new file mode 100644
index 00000000..c2e617fc
--- /dev/null
+++ b/.changeset/curly-kangaroos-clap.md
@@ -0,0 +1,5 @@
+---
+'@xyflow/react': patch
+---
+
+Improve `onNodesChange` docs
diff --git a/packages/react/src/types/component-props.ts b/packages/react/src/types/component-props.ts
index 64b94534..63f0a1be 100644
--- a/packages/react/src/types/component-props.ts
+++ b/packages/react/src/types/component-props.ts
@@ -156,14 +156,14 @@ export interface ReactFlowProps<NodeType extends Node = Node, EdgeType extends E
    * It is called on node drag, select, and move.
    * @example // Use NodesState hook to create edges and get onNodesChange handler
    * import ReactFlow, { useNodesState } from '@xyflow/react';
-   * const [edges, setNodes, onNodesChange] = useNodesState(initialNodes);
+   * const [nodes, setNodes, onNodesChange] = useNodesState(initialNodes);
    *
    * return (<ReactFlow onNodeChange={onNodeChange} {...rest} />)
-   * @example // Use helper function to update edge
+   * @example // Use helper function to update node
    * import ReactFlow, { applyNodeChanges } from '@xyflow/react';
    *
    * const onNodeChange = useCallback(
-   *  (changes) => setNode((eds) => applyNodeChanges(changes, eds)),
+   *  (changes) => setNode((nds) => applyNodeChanges(changes, nds)),
    *  [],
    * );
    *