chore: Add redirects for top docs 404s

[manovotny]

🔎 Previews:

These urls/paths should redirect now:

• https://clerk.com/docs/pr/manovotny-actually-cicada/authentication/social-connections/enstall
• https://clerk.com/docs/pr/manovotny-actually-cicada/authentication/social-connections/instagram

What does this solve? What changed?

Investigated the top 5 docs 404s from the last 7 days and added redirects for the 2 that warranted action. The other 3 were AI/truncation noise with no canonical destination.

Investigation methodology

• Searched the full Clerk GitHub org via gh search code for each URL to check for real references
• Cross-referenced each URL against existing redirects in redirects/static/docs.json
• Checked the actual file structure (docs/guides/configure/auth-strategies/social-connections/) to confirm what provider docs exist
• Validated with lint:check-duplicate-redirects and lint:check-redirects — all checks pass

Analysis of all 5 URLs

#	404 URL	Verdict	Action
1	/docs/authentication/social-connections/enstall	Legit near-miss / structural gap — Enstall is a real, instance-gated Clerk OAuth provider (clerk_go:pkg/oauth/provider/enstall.go, clerk/dashboard provider meta, clerk/javascript runtime). The JS SDK ships this exact URL as the docsUrl for the provider in packages/shared/src/oauth.ts and runtime-values.ts, so the 404 traffic is real users following the SDK's pointer. No docs page exists.	✅ Added redirect to social-connections overview as a fallback. See Other resources for the engineering follow-up.
2	/docs/qui	Truncation noise — 3 chars after /docs/; almost certainly a truncated display of /docs/quickstart / /docs/quickstarts/*. Both /docs/quickstarts and /docs/quickstart already redirect to the right places. The bare truncated path is not a real URL.	Skipped
3	/docs/authentication/social-connection-with-instagram	AI-guessed — Old social-connection-with-* URL pattern, but Instagram never had a docs page at that path (zero references in clerk org for this exact URL). Likely a model extrapolating from sibling providers (-with-facebook, -with-github, etc). The new-format URL (#5) is the one the SDK actually emits.	Skipped
4	/docs/authentication/configuration/si	Truncation noise — Truncated display of /docs/authentication/configuration/sign-up-sign-in-options (often with a #social-connections-o-auth fragment, as referenced from clerk/clerk-android and several blog posts). The full URL already resolves; the bare /si prefix is not a real URL.	Skipped
5	/docs/authentication/social-connections/instagram	Legit near-miss / structural gap — Instagram is a real Clerk OAuth provider with full support across clerk_go, clerk/javascript, clerk/dashboard, clerk-ios, and clerk-android. The JS SDK ships this exact URL as the docsUrl in packages/shared/src/oauth.ts and runtime-values.ts. No docs page exists.	✅ Added redirect to social-connections overview as a fallback. See Other resources for the engineering follow-up.

Changes

Static redirects (redirects/static/docs.json):

• /docs/authentication/social-connections/enstall → /docs/guides/configure/auth-strategies/social-connections/overview
• /docs/authentication/social-connections/instagram → /docs/guides/configure/auth-strategies/social-connections/overview

Deadline

• No rush

Other resources

• Engineering follow-up (clerk/javascript): The enstall and instagram docsUrl entries in packages/shared/src/oauth.ts and packages/shared/src/types/runtime-values.ts point to docs pages that don't exist. The fallback redirects in this PR send users to the social-connections overview, but the real fix is either (a) write per-provider docs for Instagram and Enstall under docs/guides/configure/auth-strategies/social-connections/, or (b) drop/repoint the docsUrl field for these providers.
• Previous 404 redirect PR: #3359

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
clerk-docs	Ready	Preview	May 26, 2026 3:11pm

[SarahSoutoul]

Not sure if this was ready for review as it's still in draft, but LGTM!