diff --git a/packages/react/src/types/instance.ts b/packages/react/src/types/instance.ts
index 01bb0c13..5806353f 100644
--- a/packages/react/src/types/instance.ts
+++ b/packages/react/src/types/instance.ts
@@ -177,7 +177,7 @@ export type GeneralHelpers<NodeType extends Node = Node, EdgeType extends Edge =
    * Gets all connections for a given handle belonging to a specific node.
    *
    * @param type - handle type 'source' or 'target'
-   * @param id - the handle id
+   * @param id - the handle id (this is only needed if you have multiple handles of the same type, meaning you have to provide a unique id for each handle)
    * @param nodeId - the node id the handle belongs to
    * @returns an array with handle connections
    */
diff --git a/packages/svelte/src/lib/hooks/useSvelteFlow.ts b/packages/svelte/src/lib/hooks/useSvelteFlow.ts
index 7fb7f5cf..9aa16388 100644
--- a/packages/svelte/src/lib/hooks/useSvelteFlow.ts
+++ b/packages/svelte/src/lib/hooks/useSvelteFlow.ts
@@ -236,7 +236,7 @@ export function useSvelteFlow(): {
    * Gets all connections for a given handle belonging to a specific node.
    *
    * @param type - handle type 'source' or 'target'
-   * @param id - the handle id
+   * @param id - the handle id (this is only needed if you have multiple handles of the same type, meaning you have to provide a unique id for each handle)
    * @param nodeId - the node id the handle belongs to
    * @returns an array with handle connections
    */