diff --git a/sdk/src/user.ts b/sdk/src/user.ts
index 043ac27a3..0296dd63e 100644
--- a/sdk/src/user.ts
+++ b/sdk/src/user.ts
@@ -4260,7 +4260,8 @@ export class User {
 	}
 
 	/**
-	 * Compute a consolidated margin snapshot once, without caching.
+	 * Compute the full margin calculation for the user's account.
+	 * Prioritize using this function instead of calling getMarginRequirement or getTotalCollateral multiple times.
 	 * Consumers can use this to avoid duplicating work across separate calls.
 	 */
 	public getMarginCalculation(