Skip to content

Refactor user authentication/SSO section#3374

Draft
im2nguyen wants to merge 3 commits into
mainfrom
tu/sso-brainstorm
Draft

Refactor user authentication/SSO section#3374
im2nguyen wants to merge 3 commits into
mainfrom
tu/sso-brainstorm

Conversation

@im2nguyen
Copy link
Copy Markdown
Contributor

@im2nguyen im2nguyen commented May 15, 2026

🔎 Previews:

What does this solve? What changed?

Currently the SSO section in the docs is not super intuitive. For example, if you want to configure SAML or OIDC on your app, you need to go through 4 layers in the docs.

This collapses the nesting and makes it more aligned to the Clerk dashboard's "User & authentication" section.

This PR is more of a preview to start a conversation about the docs, and not a final proposal for the docs. Heavily used claude as a sparring partner and had it implemented the changes. Told claude to put changes and rationale in the changes.md file though.

Current:
image

Proposed:
image

Deadline

Other resources

@im2nguyen im2nguyen requested a review from a team as a code owner May 15, 2026 03:16
@vercel
Copy link
Copy Markdown

vercel Bot commented May 15, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clerk-docs Ready Ready Preview May 15, 2026 3:56am

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

⚠️ TypeDoc files detected in this PR

This PR modifies files in the 'clerk-typedoc/' folder. These files are auto-generated from the clerk/javascript repository and should not be edited directly.

To make changes to TypeDoc documentation:

  1. 🔄 Make your changes in the appropriate files in the clerk/javascript repository.
  2. 🚀 The TypeDoc documentation will be pulled through to this repository via a CI action.

Thanks for contributing! 🙏

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant