Skip to content

docs: replace drifted adapter list on docs home with canonical overview link - #14157

Merged
detail-app[bot] merged 1 commit into
mainfrom
detail/fix-docs/docs-replace-drifted-adapter-list-on-docs-home-wit-615fed
Sep 6, 2026
Merged

docs: replace drifted adapter list on docs home with canonical overview link#14157
detail-app[bot] merged 1 commit into
mainfrom
detail/fix-docs/docs-replace-drifted-adapter-list-on-docs-home-wit-615fed

Conversation

@detail-app

@detail-app detail-app Bot commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

Summary

Related Issue: #

Corrects the "Framework Adapters (Recommended)" section on the docs landing page,
which had drifted from the canonical adapter classification.

What

Replaced the hand-curated adapter CardGroup + "All 12 supported frameworks"
Expandable on docs/introduction.mdx with a single Card linking to the new
canonical overview at /integrate/sdk/adapters/introduction.

Why

The enumerated list conflicted with the canonical active-vs-deprecated adapter
classification in multiple ways:

  • Listed Deno as "Recommended" even though it is deprecated/Legacy.
  • Buried Nuxt and TanStack Start — both active — inside an "All 12"
    expandable.
  • Stated "12" frameworks while showing 10 cards, with Deno duplicated and
    Supabase missing.

A developer following the homepage would have been directed to a deprecated
adapter as a recommended option and overlooked active adapters like Nuxt and
TanStack Start. Pointing at the canonical overview page keeps the homepage in
sync with the navigation dropdown and resists future drift as the adapter set
changes.

How

Single Card linking to the same canonical overview target the desktop
navigation dropdown now routes to, with a description naming the 5 active
adapters (Next.js, Nuxt, TanStack Start, Laravel, BetterAuth).

Checklist

  • This PR addresses a single concern (one bug fix, one feature, one refactor)
  • The diff is reasonably sized and easy to review
  • New functionality is covered by tests
  • Linting and type checking pass (uv run task lint && uv run task lint_types)
  • No unrelated changes or drive-by fixes are included

Introduced by commit 68660ad (@pieterbeulque, #14135)


Doc Drift PRs can be configured here.

Review in cubic

@detail-app
detail-app Bot requested a review from pieterbeulque as a code owner September 5, 2026 22:48
@mintlify

mintlify Bot commented Sep 5, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Polar 🟢 Ready View Preview Sep 5, 2026, 10:50 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@vercel

vercel Bot commented Sep 5, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated
orbit Ready Ready Preview Sep 5, 2026 10:52pm UTC
polar-test Ready Ready Preview Sep 5, 2026 10:52pm UTC

Request Review

@pieterbeulque pieterbeulque left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That "recommended" in the title is also TBD :-)

@detail-app
detail-app Bot added this pull request to the merge queue Sep 6, 2026
Merged via the queue into main with commit 824644b Sep 6, 2026
44 of 53 checks passed
@detail-app
detail-app Bot deleted the detail/fix-docs/docs-replace-drifted-adapter-list-on-docs-home-wit-615fed branch September 6, 2026 07:29
@detail-app

detail-app Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor Author

Detail merged this PR automatically because auto-merge is enabled for Doc Drift PRs on this repository. You can change this in the Doc Drift settings.

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