docs: add Prisma Next getting started guides#7933
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
Note Reviews pausedIt looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the Use the following commands to manage reviews:
Use the checkboxes below for quick actions:
WalkthroughThis PR reorganizes Prisma Next docs: adds Prisma Postgres quickstarts and import guides, creates a /next/getting-started hub and a "What is Prisma Next?" page, harmonizes add-to-existing instructions, updates redirects/version mappings, and adjusts banner styling and sidebar badge behavior. ChangesPrisma Next Documentation Hub Restructuring
Estimated code review effort🎯 3 (Moderate) | ⏱️ ~25 minutes Possibly related PRs
🚥 Pre-merge checks | ✅ 4 | ❌ 1❌ Failed checks (1 warning)
✅ Passed checks (4 passed)
Comment |
🍈 Lychee Link Check Report104 links: ✅ All links are working!Full Statistics Table
|
|
The latest updates on your projects. Learn more about Argos notifications ↗︎
|
|
@AmanVarshney01 The versioning dropdown currently lets users switch to the Prisma Next docs, which is great. Could we also make Prisma Next more prominent in the latest docs? Since Prisma Next will become the next major version, it would be useful to add a clear callout encouraging users to try it out and share feedback. |
…aning Keeps the Early Access -> Preview -> GA ladder monotonic: Preview is now described as close to stable, validate in staging, rather than "not recommended in production." Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Redirect bare /docs to /docs/next so the docs land on Prisma Next by default. Keep the Prisma 7 (Latest) getting-started reachable at /docs/getting-started: repoint the getting-started version switcher's Latest target and the Getting Started tab there (bare "/" now redirects), and update the callouts' Prisma 7 links to /getting-started. - Add spacing under the callout title so the heading no longer sits flush against the body (applies to all callouts via CalloutTitle). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Incorporate Ty's feedback on the Prisma Next getting-started docs: - Remove the auto-redirect from bare /docs to /docs/next; the docs now land on Introduction to Prisma. - Remove the "Docs version" dropdown on getting-started pages. Prisma Next lives inline in the getting-started sidebar as its own sections instead of a separate rooted version. The ORM version dropdown is unchanged. - Restructure the getting-started sidebar into: Getting Started, Get started with Prisma Next, Prisma Next (Quickstart + Add to Existing Project), Prisma ORM, and Prisma Postgres. - Add a Prisma Next entry to the Prisma Postgres > Quickstart dropdown; the page moves to /prisma-postgres/quickstart/prisma-next with a redirect from the old path. - Add a non-forceful Prisma Next callout on Introduction to Prisma. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…king Goal 1: make Prisma Next more discoverable to readers and agents. Update the Prisma Next copy across the docs to the assertive standard line: "Prisma Next is the next major version of Prisma ORM, available now in Early Access. We strongly recommend trying it out before it becomes generally available..." Replaces the softer "we'd love for you to try it" callouts and the fluffy "Curious what's next?" intro note. Goal 2: move the prisma-docs-voice (docs writer) skill into the repo at .claude/skills/prisma-docs-voice and extend it for Prisma Next. The new references/prisma-next.md makes the Prisma Next repo the source of truth (fact-check every behavioral claim against packages/, examples/, docs/, and the installed agent skills before writing), follows the Prisma Next user-docs spec for information architecture, calls out deltas from Prisma 7, and refuses to guess when behavior is unclear. Goal 3: track redirects. references/redirects-tracking.md documents the URL migration model (Prisma Next ORM docs authored at /docs/orm/next, promoted to /docs/orm at GA, with Prisma 7 pinned to /docs/orm/v7) and the tracking-file format. apps/docs/prisma-next-redirects.md is the concrete decision log, seeded with this PR's moves. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
What this PR does
This PR brings the Prisma Next documentation into the repo, makes Prisma Next the default experience when you land in the docs, and updates how we talk about Early Access across the docs and blog.
Prisma Next is the next major version of Prisma ORM and is currently in Early Access. Prisma 7 remains the generally available (GA) release.
TL;DR of what changed
/docsnow redirects to/docs/next, and the website nav Docs / ORM links (plus the footer ORM link) open the Prisma Next docs. The ORM Next intro is labeled Prisma Next in the sidebar, matching the Prisma ORM (Latest) docs.Notes
/docsredirects to/docs/next. The Prisma 7 (Latest) getting-started stays reachable at/docs/getting-started— that's where the getting-started version switcher's Latest option and the callouts' Prisma 7 links point — and/docs/ormstill serves the Prisma ORM 7 docs.Validation
pnpm --filter docs run lint:links— 0 errorspnpm --filter docs run lint:spellcheckpnpm --filter docs run types:check