Skip to content

Blog refresh: Prisma Schema Language post (answer-first, verified on 7.8) - #8020

Merged
ankur-arch merged 2 commits into
mainfrom
blog/refresh-prisma-schema-language
Jul 8, 2026
Merged

Blog refresh: Prisma Schema Language post (answer-first, verified on 7.8)#8020
ankur-arch merged 2 commits into
mainfrom
blog/refresh-prisma-schema-language

Conversation

@vanrensbird

@vanrensbird vanrensbird commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

What

Refresh of /blog/prisma-schema-language-the-best-way-to-define-your-data (shortlist #5). GSC shows 32k impressions in the last 90 days at position 6.4 with 0.34% CTR, so the core fix is meta + answer-first intro; the body holds up well.

Changes

  • metaDescription: was "An article discussing the Prisma Schema Language and comparing it to TypeScript-based schemas." Now an answer-first definition with the comparison and AI angle.
  • Intro: rewritten as a standalone definition block (what PSL is, what Prisma generates from it) so the opening paragraph answers "what is Prisma Schema Language" without needing the rest of the page.
  • Invalid code sample fixed: the Customer/Order snippet failed prisma validate on 7.8.0 ("The relation field customer on model Order is missing an opposite relation field on the model Customer"). Added the orders Order[] back-relation.
  • Verification: every PSL sample in the post plus the findMany query ran against a live database on Prisma ORM 7.8.0 (validate, db push, generate, live queries including the implicit many-to-many with a relation filter).
  • Dead links: /docs/orm/tools/prisma-cli (now v6-only) → /docs/orm/reference/prisma-cli-reference; closing CTA /docs/getting-started/quickstart-prismaPostgres (404) → /docs/prisma-orm/quickstart/prisma-postgres.
  • Currency: added a short multi-file schema note (GA since 6.7.0, prisma.config.ts schema directory in v7) linking the refreshed multi-file post.
  • Prisma Next section per refresh policy, framed carefully so it extends rather than contradicts the post's thesis: the value is the single declarative data contract, which Prisma Next keeps while adding a TypeScript authoring option.
  • Slug, author, publish date unchanged; updatedAt bumped to 2026-07-06. Link linter passes for this file.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Updated the article’s metadata and introduction for clearer positioning.
    • Refined guidance on Prisma CLI integration and multi-file schema setup, including Prisma ORM v7 schema-directory configuration.
    • Improved the example schema snippet to show a relation field and cleaned up formatting.
    • Revised the Prisma Next section with updated wording and links.

… 7.8

Shortlist #5 (32k impressions, 0.34% CTR): the core fix is the meta and
intro. metaDescription was "An article discussing..." with zero answer
content; now an answer-first definition. Intro rewritten as a standalone
definition block for extraction.

Corrections verified on Prisma ORM 7.8.0 against a live database:
- The Customer/Order sample was invalid PSL: it failed prisma validate
  with "missing an opposite relation field" (relations require both
  sides). Added the orders back-relation; validated.
- All other schema samples and the findMany query verified via
  validate, db push, generate, and live queries including the implicit
  many-to-many.

Also: dead /docs/orm/tools/prisma-cli link repointed to the CLI
reference, dead quickstart-prismaPostgres CTA repointed to the current
Prisma Postgres quickstart, added multi-file schema note (GA since
6.7.0, prisma.config.ts directory in v7) linking the refreshed
multi-file post, and added the Prisma Next section per refresh policy,
framed as the data contract carrying PSL's ideas forward. Slug, author,
publish date unchanged; updatedAt bumped.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vanrensbird
vanrensbird requested a review from ankur-arch July 6, 2026 16:17
@vercel

vercel Bot commented Jul 6, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
blog Ready Ready Preview, Comment Jul 8, 2026 1:59pm
docs Ready Ready Preview, Comment Jul 8, 2026 1:59pm
eclipse Ready Ready Preview, Comment Jul 8, 2026 1:59pm
site Ready Ready Preview, Comment Jul 8, 2026 1:59pm

Request Review

@argos-ci

argos-ci Bot commented Jul 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build Status Details Updated (UTC)
default (Inspect) ✅ No changes detected - Jul 8, 2026, 2:06 PM

@coderabbitai

coderabbitai Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: d2f1751c-bf81-4d44-8a23-d2353f2d893e

📥 Commits

Reviewing files that changed from the base of the PR and between 7b84d5d and 5ed024a.

📒 Files selected for processing (1)
  • apps/blog/content/blog/prisma-schema-language-the-best-way-to-define-your-data/index.mdx

Walkthrough

This PR updates the "Prisma Schema Language" blog article's frontmatter (updatedAt, metaDescription), intro paragraph, Prisma CLI/multi-file schema guidance and links, the Customer model code example (adding an orders relation), and the closing Prisma Next section's links and text.

Changes

Blog article content revisions

Layer / File(s) Summary
Frontmatter and intro copy
apps/blog/content/blog/prisma-schema-language-the-best-way-to-define-your-data/index.mdx
Bumped updatedAt to 2026-07-06, rewrote metaDescription, and revised the opening paragraph about PSL and Prisma ORM.
CLI guidance and example snippet
apps/blog/content/blog/prisma-schema-language-the-best-way-to-define-your-data/index.mdx
Updated Prisma CLI documentation link and multi-file schema guidance (Prisma ORM v7 prisma.config.ts), and added an orders Order[] relation field with reformatting to the Customer model example.
Prisma Next section and closing links
apps/blog/content/blog/prisma-schema-language-the-best-way-to-define-your-data/index.mdx
Revised Prisma Next wording, performance/packaging text, and updated the early-access and "Get started" documentation links.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Possibly related PRs

  • prisma/web#7991: Both PRs change metaDescription frontmatter copy in blog MDX content.
  • prisma/web#8000: Both PRs update Prisma ORM 7 content around prisma.config.ts schema configuration and relation-field examples.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@ankur-arch
ankur-arch merged commit b17f95b into main Jul 8, 2026
10 of 15 checks passed
@ankur-arch
ankur-arch deleted the blog/refresh-prisma-schema-language branch July 8, 2026 13:56
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.

2 participants