update overview

Author: ethanpalm

protected-pages/overview.mdx

@@ -10,22 +10,36 @@ keywords: ["auth", "authentication"]
   plans](https://mintlify.com/pricing?ref=authentication).
 </Info>
 
-Restrict access to your documentation with a password or with a third-party authentication provider.
+Choose how users authenticate to access your documentation.
 
 You can make all of your content private or control access on a page-by-page basis.
 
-## Handshake methods
+## Authentication methods
 
-**JSON Web Token (JWT)**: Custom system where you manage user tokens with full control over the login flow.
+Choose between simple shared password access or individual user authentication based on your security needs.
+
+### Password protection
+
+Shared access with a single global password.
+
+- Pros of password protection:
+  - Simple setup with no configuration required to add new users. Just share the password.
+- Cons of password protection:
+  - Cannot differentiate between users with the same password.
+  - Must change the password to revoke access.
+
+### Identity provider authentication
 
+Authenticate individual users with one of the following methods.
+
+**JSON Web Token (JWT)**: Custom system where you manage user tokens with full control over the login flow.
 - Pros of JWT:
   - Reduced risk of API endpoint abuse.
   - No CORS configuration.
   - No restrictions on API URLs.
 - Cons of JWT:
   - Must be compatible with your existing login flow.
-  - Dashboard sessions and docs authentication are decoupled, so your team will log into your dashboard and your docs separately.
-  - When you refresh user data, users must log into your docs again. If your users' data changes frequently, they must log in frequently or risk having stale data in your docs.
+  - Users log into your dashboard and docs separately.
 
 **OAuth 2.0**: Third-party login integration like Google, GitHub, or other OAuth providers.
 
@@ -34,7 +48,7 @@ You can make all of your content private or control access on a page-by-page bas
   - No restrictions on API URLs.
 - Cons of OAuth 2.0:
   - Requires significant work if setting up an OAuth server for the first time.
-  - Dashboard sessions and docs authentication are decoupled, so your team will log into your dashboard and your docs separately.
+  - Users log into your dashboard and docs separately.
 
 **Mintlify dashboard**: Allow all of your dashboard users to access your docs.
 
@@ -44,10 +58,15 @@ You can make all of your content private or control access on a page-by-page bas
 - Cons of Mintlify dashboard:
   - Requires all users of your docs to have an account in your Mintlify dashboard.
 
-**Password**: Shared access with a single global password. Used for access control only. Does not allow for personalization.
+## Choose your method
 
-- Pros of password:
-  - Simple setup with no configuration required to add new users, just share the password.
-- Cons of password:
-  - Lose personalization features since there is no way to differentiate users with the same password.
-  - Must change the password to revoke access.
+**Use password protection if**:
+
+- You want a simple, quick setup.
+- All authorized users can share the same password.
+- You don't need to track individual users.
+
+**Use identity provider authentication if**:
+
+- You need to identify individual users.
+- You want to integrate with existing login flows.