add OAuth info

Author: ethanpalm

authentication-personalization/authentication-setup.mdx

@@ -17,11 +17,11 @@ Authentication requires users to log in before accessing your documentation. Thi
 Select the handshake method that you want to configure.
 
 <Tabs>
-  <Tab title="JWT">
+<Tab title="JWT">
 ### Prerequisites
 
- * An authentication system that can generate and sign JWTs.
- * A backend service that can create redirect URLs.
+* An authentication system that can generate and sign JWTs.
+* A backend service that can create redirect URLs.
 
 ### Implementation
 
@@ -44,6 +44,7 @@ Select the handshake method that you want to configure.
 </Steps>
 
 ### Example
+
 Your documentation is hosted at `docs.foo.com` with an existing authentication system at `foo.com`. You want to extend your login flow to grant access to the docs.
 
 To do this, create a login endpoint at `https://foo.com/docs-login` that extends your existing authentication.
@@ -117,54 +118,60 @@ When an unauthenticated user tries to access a protected page, their intended de
 2. Redirect to your login URL with a redirect query parameter: `https://foo.com/docs-login?redirect=%2Fquickstart`.
 3. After authentication, redirect to `https://docs.foo.com/login/jwt-callback?redirect=%2Fquickstart#{SIGNED_JWT}`.
 4. User lands in their original destination.
-  </Tab>
+</Tab>
 <Tab title="OAuth 2.0">
 ### Prerequisites
 
-- You have an existing OAuth server that supports the Authorization Code flow.
-    - You can create a new API endpoint that can be accessed by the returned OAuth access token.
+* An OAuth server that supports the Authorization Code Flow.
+* Ability to create an API endpoint accessible by OAuth access tokens (optional, to enable personalization features).
 
 ### Implementation
 
 <Steps>
-  <Step title="Configure your Authentication settings">
-    Go to your [Mintlify authentication settings](https://dashboard.mintlify.com/products/authentication), select the OAuth option, and fill out the required fields:
-
-    - **Authorization URL**: The base URL for the authorization request, to which we will add the appropriate query parameters.
-    - **Client ID**: An ID for the OAuth 2.0 client to be used.
-    - **Scopes**: An array of scopes that will be requested. TODO: clarify why there could be multiple
-    - **Token URL**: The base URL for the token exchange request.
-    - **Info API URL** (optional): The endpoint that will be hit to retrieve user info. If omitted, the OAuth flow will only be used to verify identity, and the user info will be empty.
+  <Step title="Configure your OAuth settings.">
+    1. In your dashboard, go to [Authentication](https://dashboard.mintlify.com/settings/deployment/authentication).
+    2. Select **Full Authentication** or **Partial Authentication**.
+    3. Select **OAuth** and configure these fields:
+      * **Authorization URL**: Your OAuth endpoint.
+      * **Client ID**: Your OAuth 2.0 client identifier.
+      * **Client Secret**: Your OAuth 2.0 client secret.
+      * **Scopes**: Permissions to request. Use multiple scopes if you need different access levels.
+      * **Token URL**: Your OAuth token exchange endpoint.
+      * **Info API URL** (optional): Endpoint to retrieve user info for personalization. If omitted, the OAuth flow will only be used to verify identity and the user info will be empty.
+    4. Select **Save changes**.
   </Step>
-  <Step title="Configure your OAuth client">
-    Copy the Redirect URL listed in the [Mintlify authentication settings](https://dashboard.mintlify.com/products/authentication) and add it as an authorized redirect URL for your OAuth server.
+  <Step title="Configure your OAuth server.">
+    1. Copy the **Redirect URL** from your [authentication settings](https://dashboard.mintlify.com/settings/deployment/authentication).
+    2. Add the redirect URL as an authorized redirect URL for your OAuth server.
   </Step>
-  <Step title="Create your Info API (Optional)">
-    If you want to take advantage of authentication's customization features, you'll need to create an endpoint to retrieve info about your users.
-    Create an API endpoint that can be accessed with an OAuth access token, and responds with a JSON payload following the [User](../sending-data) format.
-
-    Return to your [Mintlify authentication settings](https://dashboard.mintlify.com/products/authentication) and add the Info API URL
-    to your OAuth configuration.
+  <Step title="Create your user info endpoint (optional).">
+    To enable personalization features, create an API endpoint that:
+    * Accepts OAuth access tokens for authentication.
+    * Returns user data in the `User` format. See [Sending Data](/authentication-personalization/sending-data) for more information.
+    
+    Add this endpoint URL to the **Info API URL** field in your [authentication settings](https://dashboard.mintlify.com/settings/deployment/authentication).
   </Step>
 </Steps>
 
 ## Example
 
-I have an existing OAuth server that supports the Authorization Code flow. I want to set up authentication for my docs hosted at `foo.com/docs`.
+Your documentation is hosted at `foo.com/docs` and you have an existing OAuth server at `auth.foo.com` that supports the Authorization Code Flow.
 
-To set up authentication with Mintlify, I create an endpoint `api.foo.com/docs/user-info` which requires an OAuth access token with the `docs-user-info` scope, and responds with the user's custom data according to Mintlify’s specification.
-
-I then go to the dashboard settings, navigate to the Authentication settings, select OAuth, and enter the relevant values for the OAuth flow and Info API endpoint:
+To set up authentication with Mintlify, configure your OAuth server details in your dashboard:
 - **Authorization URL**: `https://auth.foo.com/authorization`
 - **Client ID**: `ydybo4SD8PR73vzWWd6S0ObH`
 - **Scopes**: `['docs-user-info']`
 - **Token URL**: `https://auth.foo.com/exchange`
 - **Info API URL**: `https://api.foo.com/docs/user-info`
 
-Finally, I copy the Redirect URL displayed in the dashboard settings and add it as an authorized redirect URL in my OAuth client configuration settings.
 
+ create an endpoint `api.foo.com/docs/user-info` which requires an OAuth access token with the `docs-user-info` scope, and responds with the user's custom data according to Mintlify’s specification.
 
-  </Tab>
+I then go to the dashboard settings, navigate to the Authentication settings, select OAuth, and enter the relevant values for the OAuth flow and Info API endpoint:
+
+
+Finally, I copy the Redirect URL displayed in the dashboard settings and add it as an authorized redirect URL in my OAuth client configuration settings.
+</Tab>
 <Tab title="Mintlify Dashboard">
 ### Prerequisites