diff --git a/packages/auth/src/core/index.ts b/packages/auth/src/core/index.ts
index 921d1fd57d2..54bfb3491d5 100644
--- a/packages/auth/src/core/index.ts
+++ b/packages/auth/src/core/index.ts
@@ -89,8 +89,8 @@ export function onIdTokenChanged(
  *
  * @param auth - The {@link Auth} instance.
  * @param callback - callback triggered before new user value is set.
- *   If this throws, it will block the user from being set.
- * @param onAbort - callback triggered if a later before state changed
+ *   If this throws, it blocks the user from being set.
+ * @param onAbort - callback triggered if a later `beforeAuthStateChanged()`
  *   callback throws, allowing you to undo any side effects.
  */
  export function beforeAuthStateChanged(
diff --git a/packages/auth/src/model/public_types.ts b/packages/auth/src/model/public_types.ts
index b5c222b5ff0..5aab9972eb0 100644
--- a/packages/auth/src/model/public_types.ts
+++ b/packages/auth/src/model/public_types.ts
@@ -259,8 +259,8 @@ export interface Auth {
    * sets a new user.
    *
    * @param callback - callback triggered before new user value is set.
-   *   If this throws, it will block the user from being set.
-   * @param onAbort - callback triggered if a later before state changed
+   *   If this throws, it blocks the user from being set.
+   * @param onAbort - callback triggered if a later `beforeAuthStateChanged()`
    *   callback throws, allowing you to undo any side effects.
    */
   beforeAuthStateChanged(