Skip to content

blog: add product callouts to two ORM posts#7983

Open
ankur-arch wants to merge 3 commits into
mainfrom
blog/product-callouts-orm-posts
Open

blog: add product callouts to two ORM posts#7983
ankur-arch wants to merge 3 commits into
mainfrom
blog/product-callouts-orm-posts

Conversation

@ankur-arch

@ankur-arch ankur-arch commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

What

Adds coherent, in-context callouts and CTAs to two ranking ORM blog posts, per the "Update & Optimize" SEO task. Each callout leads with something useful to the reader and ties to the surrounding content rather than reading like a launch email.

backend-prisma-typescript-orm-with-postgresql-data-modeling (series part 1)

  • Series-navigation callout near the top linking the other three parts.
  • Prisma Postgres callout at the database-setup step, framed as an alternative to the local Docker container (every step below is the same either way).
  • Closing note on versions: points to Prisma Next as the ORM's direction and lands Prisma Postgres + Prisma Compute on the deployment installment (part four).

why-prisma-orm-generates-code-into-node-modules-and-why-it-ll-change

  • Mid-article callout connecting the node_modules change to Prisma Next.
  • Closing "new project" callout offering Prisma Postgres + Prisma Compute when setting an output path.

Notes

  • Callouts use the repo's ::: directive syntax (ppg/note/tip), all balanced.
  • Prisma Compute is marked public beta throughout; no unsourced absolutes; no em dashes (house style).
  • Ran a deslop/clarity pass: tightened sentences, locked terminology, split an over-long sentence, spelled small numbers.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Updated the blog tutorial with a clearer four-part series roadmap and improved “next in the series” navigation.
    • Added alternative setup guidance that skips Docker by using a direct Postgres connection string while keeping the tutorial flow the same.
    • Refreshed content explaining Prisma Client generation behavior, upcoming changes (including requiring an output location), and related dev-time implications.
    • Added tips for new projects, recommending current Prisma tooling for provisioning and hosting.

Add coherent in-context callouts and CTAs to two ranking ORM blog posts,
pointing readers to Prisma Next, the individual posts/series, and our
commercial products (Prisma Postgres + Prisma Compute).

- backend-prisma-typescript-orm-with-postgresql-data-modeling: series
  navigation, a Prisma Postgres alternative to local Docker at the DB
  setup step, and a closing note on Prisma Next + Postgres/Compute.
- why-prisma-orm-generates-code-into-node-modules-and-why-it-ll-change:
  tie the node_modules change to Prisma Next, and a new-project callout
  for Prisma Postgres + Compute.

Callouts use the repo's ::: directive syntax; Compute is marked public
beta throughout.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 26, 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 Jun 26, 2026 10:56am
docs Ready Ready Preview, Comment Jun 26, 2026 10:56am
eclipse Ready Ready Preview, Comment Jun 26, 2026 10:56am
site Ready Ready Preview, Comment Jun 26, 2026 10:56am

Request Review

@coderabbitai

coderabbitai Bot commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 1e922c7e-fd2e-46c7-8534-1267c517e92d

📥 Commits

Reviewing files that changed from the base of the PR and between cfa1835 and 2a8c849.

📒 Files selected for processing (2)
  • apps/blog/content/blog/backend-prisma-typescript-orm-with-postgresql-data-modeling-tsjs1ps7kip1/index.mdx
  • apps/blog/content/blog/why-prisma-orm-generates-code-into-node-modules-and-why-it-ll-change/index.mdx
✅ Files skipped from review due to trivial changes (2)
  • apps/blog/content/blog/backend-prisma-typescript-orm-with-postgresql-data-modeling-tsjs1ps7kip1/index.mdx
  • apps/blog/content/blog/why-prisma-orm-generates-code-into-node-modules-and-why-it-ll-change/index.mdx

Walkthrough

Two blog posts were updated with new and rewritten MDX callouts. One adds series navigation, a Docker alternative, and version guidance. The other revises Prisma Client generation explanations and adds Prisma Next and Prisma Postgres references.

Changes

Blog content updates

Layer / File(s) Summary
Backend tutorial notes
apps/blog/content/blog/backend-prisma-typescript-orm-with-postgresql-data-modeling-tsjs1ps7kip1/index.mdx
Adds a part list after the video embed, a Docker-free DATABASE_URL option in prerequisites, and a closing Prisma version note with next-series links.
Prisma Next callouts
apps/blog/content/blog/why-prisma-orm-generates-code-into-node-modules-and-why-it-ll-change/index.mdx
Rewrites the generated-client explanation, updates the node_modules rationale, adds an output note, clarifies linting behavior, and adds a new-project callout pointing to Prisma Postgres, Prisma Compute, and Prisma Next.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

  • prisma/web#7925: Also touches backend-prisma-typescript-orm-with-postgresql-data-modeling-tsjs1ps7kip1/index.mdx, with related series/frontmatter updates for the same tutorial.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main change: adding product callouts to two ORM blog posts.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

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

@argos-ci

argos-ci Bot commented Jun 26, 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 - Jun 26, 2026, 11:03 AM

- Compliance with the assumption that `node_modules` can only be modified by package managers.

:::note[Part of a bigger change]
Getting the generated client out of `node_modules` is one piece of a bigger change. [Prisma Next](https://www.prisma.io/blog/the-next-evolution-of-prisma-orm) takes the idea all the way: you keep a single data contract, and the generated client lands in your source tree as normal code. You can read it, commit it, and bundle it like anything else, never hidden in `node_modules`.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I'm not sure how this connects.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Reworked this callout — it no longer jumps to "data contract" (off-topic for this article). It now bridges directly from the v7 output-path change to Prisma Next: the same principle (treat the generated client as ordinary source code in your project, not something hidden in node_modules), carried forward into the next major version.

As always, [reach out to us on X](https://pris.ly/x) or [join our Discord](https://pris.ly/discord) if you have any feedback or questions!

:::ppg[Starting a new project?]
If you're setting an `output` path on a new project as suggested above, the database and hosting can come from the same place. [Prisma Postgres](https://www.prisma.io/postgres) gives you a managed Postgres database, and [Prisma Compute](https://www.prisma.io/compute) (public beta) runs your TypeScript app next to it. The ORM itself is heading toward [Prisma Next](https://www.prisma.io/blog/the-next-evolution-of-prisma-orm).

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

not sure how this connects.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Reconnected to the article's own "starting a new project today" advice. If you're setting an output path on a fresh project, you still need a database for DATABASE_URL to point at — so the callout now leads with npx create-db (Prisma Postgres), then Prisma Compute for hosting, then Prisma Next for where the ORM goes after v7.

> **Note**: If you don't want to use Docker, you can set up a [local PostgreSQL database](https://www.prisma.io/dataguide/postgresql/setting-up-a-local-postgresql-database) or a [hosted PostgreSQL database on Heroku](https://dev.to/prisma/how-to-setup-a-free-postgresql-database-on-heroku-1dc1).

:::ppg[Don't want to run Docker?]
The tutorial runs Postgres in a local container, which still works. If you'd rather skip that, create a [Prisma Postgres](https://www.prisma.io/postgres) database and use its connection string as your `DATABASE_URL`. Every schema, migration, and query step below is the same either way.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

You can use local prisma postgres or npx create-db, provide back links to our docs.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Done. The callout now points to npx create-db (https://www.prisma.io/docs/postgres/introduction/npx-create-db) and local Prisma Postgres (https://www.prisma.io/docs/postgres/database/local-development), both linked to docs, with the connection string going straight into DATABASE_URL.

Address review comments and improve the article writing:

- node_modules post: reconnect both callouts to the article's actual
  thread (generated-code location, not a "data contract"). The mid
  callout now bridges from the v7 output-path change to Prisma Next; the
  closing callout ties to the post's own "new project" advice via
  DATABASE_URL + npx create-db, then Prisma Compute and Prisma Next.
- node_modules post: copy-edit pass preserving author voice. Fix the
  "develoeprs" typo and the broken "aware of their structure" antecedent,
  remove the em dash (house style), and tighten several long sentences.
- data-modeling post: the Docker-alternative callout now points to
  `npx create-db` and local Prisma Postgres, each linked to its docs.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Give Prisma Compute a clear, contextual mention rather than a buried
list item: serverless TypeScript hosting (public beta) that runs the app
on the same infrastructure as the Prisma Postgres database. In the
data-modeling series this ties to the deployment installment (part 4).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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