(chore) align React and Vue docs; align prop/param descriptions

docs/quickstarts/react.mdx

@@ -199,22 +199,3 @@ React Router can be integrated with Clerk in two ways:
 
 - As a framework: Use Clerk's built-in [React Router integration](/docs/quickstarts/react-router)
 - As a library: Manually integrate React Router into your Clerk application using [library mode](/docs/references/react-router/library-mode)
-
-## More resources
-
-Learn more about Clerk components, how to customize them, and how to use Clerk's client-side helpers using the following guides.
-
-<Cards>
-  - [Prebuilt components](/docs/components/overview)
-  - Learn more about Clerk's suite of components that let you quickly add authentication to your app.
-
-  ---
-
-  - [Customization & localization](/docs/customization/overview)
-  - Learn how to customize and localize Clerk components.
-
-  ---
-
-  - [Client-side helpers (hooks)](/docs/references/react/use-user)
-  - Learn more about Clerk's client-side helpers and how to use them.
-</Cards>

docs/references/react-router/get-auth.mdx

@@ -1,9 +1,9 @@
 ---
 title: '`getAuth()`'
-description: The getAuth() helper retrieves authentication state from the request object.
+description: Access and manage the current user's authentication state in your React application with Clerk's getAuth() helper.
 ---
 
-The `getAuth()` helper retrieves authentication state from the request object.
+The `getAuth()` helper retrieves the current user's authentication state from the request object.
 
 ## Parameters
 

docs/references/react/use-auth.mdx

@@ -1,111 +1,114 @@
 ---
 title: '`useAuth()`'
-description: Clerk's useAuth() hook is a convenient way to access the current auth state.
+description: Access and manage authentication state in your React application with Clerk's useAuth() hook.
 ---
 
-The `useAuth()` hook provides information about the current auth state, as well as helper methods to manage the current active session.
+The `useAuth()` hook provides access to the current authentication state and methods to manage the active session in your React application.
 
-## `useAuth()` returns
+## Returns
 
 <Properties>
-  - `isSignedIn`
+  - `isLoaded`
   - `boolean`
 
-  A boolean that returns true if the user is signed in.
+    A boolean that indicates whether Clerk has completed initialization. Initially `false`, becomes `true` once Clerk loads.
 
   ---
 
-  - `isLoaded`
+  - `isSignedIn`
   - `boolean`
 
-  A boolean that until Clerk loads and initializes, will be set to `false`. Once Clerk loads, `isLoaded` will be set to `true`.
+  A boolean that indicates whether a user is currently signed in.
 
   ---
 
   - `userId`
   - `string`
 
-  The current user's ID.
+  The unique identifier for the current user.
 
   ---
 
   - `sessionId`
   - `string`
 
-  The current user's session ID.
+  The unique identifier for the current session.
 
   ---
 
   - `orgId`
   - `string`
 
-  The current user's active organization ID.
+  The unique identifier for the user's active organization.
 
   ---
 
   - `orgRole`
   - `string`
 
-  The current user's active organization role.
+  The current user's role in their active organization.
 
   ---
 
   - `orgSlug`
   - `string`
 
-  The current user's organization slug.
+  The URL-friendly identifier of the user's active organization.
 
   ---
 
   - `signOut()`
   - `(options?: SignOutOptions) => Promise<void>`
 
-  A function that signs the user out. See the [reference documentation](/docs/references/javascript/clerk/clerk#sign-out) for more information.
-
-  ---
+  ## A function that signs out the current user. Returns a promise that resolves when complete. See the [reference doc](/docs/references/javascript/clerk/clerk#sign-out).
 
   - `getToken()`
   - `(options?: GetTokenOptions) => Promise<string | null>`
 
-  A function that returns a promise that resolves to the current user's session token. Can also be used to retrieve a custom JWT template. See the [reference documentation](/docs/references/javascript/session#get-token) for more information.
+  A function that retrieves the current user's session token or a custom JWT template. Returns a promise that resolves to the token. See the [reference doc](/docs/references/javascript/session#get-token).
 
   ---
 
   - `has()`
   - `(isAuthorizedParams: CheckAuthorizationParamsWithCustomPermissions) => boolean`
 
-  A function that returns a boolean based on the permission or role provided as parameter. Can be used for authorization. See the [reference documentation](/docs/references/nextjs/auth-object#has){{ target: '_blank' }} for more information.
+  A function that checks if the user has specific permissions or roles. See the [reference doc](/docs/references/nextjs/auth-object#has).
 </Properties>
 
 ## How to use the `useAuth()` hook
 
 > [!NOTE]
-> For Next.js apps, it's recommended to use the [`auth()`](/docs/references/nextjs/auth) helper instead of the `useAuth()` hook. Since `auth()` is used in server components, you'll need to pass the auth data to Client Components as needed. If you prefer to use the `useAuth()` hook, pass the `dynamic` prop to the `<ClerkProvider>` component, but note that this switches the app to dynamic rendering. Learn more [here](/docs/references/nextjs/rendering-modes).
+> For Next.js applications, it's recommended to use the [`auth()`](/docs/references/nextjs/auth) helper instead of `useAuth()`. Since `auth()` works in server components, you'll need to pass auth data to Client Components as needed. If you prefer `useAuth()`, enable it by passing the `dynamic` prop to `<ClerkProvider>`, but be aware this switches to dynamic rendering. Learn more [here](/docs/references/nextjs/rendering-modes).
 
-The following example demonstrates how to use the `useAuth()` hook to access the current auth state, like whether the user is signed in or not. It also demonstrates a basic example of how you could use the `getToken()` method to retrieve a session token for fetching data from an external resource.
+Use `useAuth()` to access the authentication state and fetch data using a session token:
 
-```tsx {{ filename: 'external-data-page.tsx' }}
+```tsx {{ filename: 'ExternalDataPage.tsx' }}
 import { useAuth } from '@clerk/clerk-react'
 
 export default function ExternalDataPage() {
   const { getToken, isLoaded, isSignedIn } = useAuth()
 
+  const fetchExternalData = async () => {
+    const token = await getToken()
+
+    // Fetch data from an external API
+    const response = await fetch('https://api.example.com/data', {
+      headers: {
+        Authorization: `Bearer ${token}`,
+      },
+    })
+
+    return response.json()
+  }
+
   if (!isLoaded) {
-    // Handle loading state however you like
     return <div>Loading...</div>
   }
 
   if (!isSignedIn) {
-    // Handle signed out state however you like
     return <div>Sign in to view this page</div>
   }
 
-  const fetchDataFromExternalResource = async () => {
-    const token = await getToken()
-    // Add logic to fetch your data
-    return data
-  }
-
-  return <div>...</div>
+  return <div>{/* Add your component content here */}</div>
 }
 ```

docs/references/react/use-clerk.mdx

@@ -1,20 +1,20 @@
 ---
 title: '`useClerk()`'
-description: Clerk's useClerk() hook is used to access the Clerk object, which can be used to build alternatives to any Clerk Component.
+description: Access and manage the Clerk object in your React application with Clerk's useClerk() hook.
 ---
 
-The `useClerk()` hook is a convenient way to access to the [`Clerk`](/docs/references/javascript/clerk/clerk) object, giving you the ability to build alternatives to any Clerk Component.
-
 > [!WARNING]
-> This is intended to be used for advanced use cases, like building a completely custom OAuth flow or as an escape hatch for getting access to the `Clerk` object.
+> This composable should only be used for advanced use cases, such as building a completely custom OAuth flow or as an escape hatch to access to the `Clerk` object.
+
+The `useClerk()` hook provides access to the [`Clerk`](/docs/references/javascript/clerk/clerk) object, allowing you to build alternatives to any Clerk Component.
 
-## `useClerk()` returns
+## Returns
 
 The `useClerk()` hook returns the `Clerk` object, which includes all the methods and properties listed in the [`Clerk` reference](/docs/references/javascript/clerk/clerk).
 
 ## How to use the `useClerk()` hook
 
-```tsx {{ filename: 'home.tsx' }}
+```tsx {{ filename: 'src/Home.tsx' }}
 import { useClerk } from '@clerk/clerk-react'
 
 export default function Home() {

docs/references/react/use-organization-list.mdx

@@ -1,11 +1,11 @@
 ---
 title: '`useOrganizationList()`'
-description: Clerk's useOrganizationList() hook is used to access methods for switching between active organizations and for listing the user's organization memberships, invitations, and suggestions.
+description: Access and manage the current user's organization list in your React application with Clerk's useOrganizationList() hook.
 ---
 
-The `useOrganizationList()` hook allows you to retrieve the organization memberships, invitations, or suggestions for an active user. It also provides methods for creating an organization and setting the active organization.
+The `useOrganizationList()` hook provides access to the current user's organization memberships, invitations, and suggestions. It also includes methods for creating new organizations and managing the active organization.
 
-## `useOrganizationList()` parameters
+## Parameters
 
 `useOrganizationList()` accepts a single object with the following properties:
 
@@ -84,7 +84,7 @@ type OrganizationSuggestionStatus = 'pending' | 'accepted'
   - `isLoaded`
   - `boolean`
 
-  A boolean is set to `false` until Clerk loads and initializes. Once Clerk loads, `isLoaded` will be set to `true`.
+    A boolean that indicates whether Clerk has completed initialization. Initially `false`, becomes `true` once Clerk loads.
 
   ---