Skip to content

feat(blog): add new migrations blog#7672

Merged
mhartington merged 3 commits intomainfrom
migrations-blog
Mar 27, 2026
Merged

feat(blog): add new migrations blog#7672
mhartington merged 3 commits intomainfrom
migrations-blog

Conversation

@mhartington
Copy link
Copy Markdown
Member

@mhartington mhartington commented Mar 18, 2026

Summary by CodeRabbit

  • Documentation
    • Published a new blog post introducing the "Prisma Next" migration model.
    • Outlines failure modes of traditional SQL migration runners (schema drift, branch ordering conflicts, partial failures).
    • Describes a graph-based migration format using schema hashes and ordered operations with precheck/execute/postcheck.
    • Details conflict resolution, verification/retry safety, and advanced workflows such as squashing, baselining, and splitting.

@vercel
Copy link
Copy Markdown

vercel bot commented Mar 18, 2026

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

Project Deployment Actions Updated (UTC)
blog Ready Ready Preview, Comment Mar 27, 2026 2:52pm
docs Ready Ready Preview, Comment Mar 27, 2026 2:52pm
eclipse Ready Ready Preview, Comment Mar 27, 2026 2:52pm
site Ready Ready Preview, Comment Mar 27, 2026 2:52pm

Request Review

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Mar 18, 2026

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: 83a63bbf-d68a-4be7-9c02-e2b963a64cf2

📥 Commits

Reviewing files that changed from the base of the PR and between 6e3a3d9 and cb7cfe8.

📒 Files selected for processing (1)
  • apps/blog/content/blog/rethinking-database-migrations/index.mdx
✅ Files skipped from review due to trivial changes (1)
  • apps/blog/content/blog/rethinking-database-migrations/index.mdx

Walkthrough

Adds a new MDX blog post introducing the "Prisma Next migrations" model, detailing migration.json and ops.json formats, schema-hash-based from/to transitions, operation phases (precheck/execute/postcheck), graph-based execution and conflict resolution, and migration maintenance actions (squash, baseline, split).

Changes

Cohort / File(s) Summary
New Blog Post
apps/blog/content/blog/rethinking-database-migrations/index.mdx
Adds a complete MDX article with frontmatter (title, slug, date, author, SEO/meta images, tags) explaining the Prisma Next migration format (migration.json with from/to hashes and metadata; ops.json as ordered ops with precheck/execute/postcheck), graph-based state transitions and path resolution for cross-branch conflicts, verification/retry safety, and maintenance workflows (squash, baseline, split).

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'feat(blog): add new migrations blog' is clear and directly describes the main change: adding a new blog post about database migrations.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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 and usage tips.

@argos-ci
Copy link
Copy Markdown

argos-ci bot commented Mar 18, 2026

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

Build Status Details Updated (UTC)
default (Inspect) ✅ No changes detected - Mar 27, 2026, 2:57 PM

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🧹 Nitpick comments (1)
apps/blog/content/blog/rethinking-database-migrations/index.mdx (1)

20-20: Consider varying repeated phrasing for tighter prose.

“You've probably...” appears in close proximity twice; swapping one instance for a different lead-in would improve rhythm.

Also applies to: 34-34

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@apps/blog/content/blog/rethinking-database-migrations/index.mdx` at line 20,
The two nearby sentences both start with "You've probably..."; replace one
instance (either the earlier "If you've written migrations before, you've
probably seen something like this:" or the later occurrence at the noted nearby
line) with an alternative lead-in such as "If you've worked with migrations
before..." or "Chances are you've encountered..." to avoid repetition and
tighten the prose while keeping the same meaning.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@apps/blog/content/blog/rethinking-database-migrations/index.mdx`:
- Line 182: Update the Markdown link URL for the Discord invite so it uses HTTPS
instead of HTTP: change the link target
"http://pris.ly/discord?utm_campaign=prisma-next" to
"https://pris.ly/discord?utm_campaign=prisma-next" for the line containing the
"#prisma-next" Discord link so external links remain secure.
- Around line 77-83: The fenced code block labeled "json" contains
JavaScript-style comments which are invalid JSON; update that fenced block by
either changing the language tag from `json` to `jsonc` (so comments are
allowed) or removing the `// ...` inline comments from the object so it becomes
valid JSON; locate the fenced snippet containing the keys "from", "to", and
"description" and apply the chosen fix.

---

Nitpick comments:
In `@apps/blog/content/blog/rethinking-database-migrations/index.mdx`:
- Line 20: The two nearby sentences both start with "You've probably...";
replace one instance (either the earlier "If you've written migrations before,
you've probably seen something like this:" or the later occurrence at the noted
nearby line) with an alternative lead-in such as "If you've worked with
migrations before..." or "Chances are you've encountered..." to avoid repetition
and tighten the prose while keeping the same meaning.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 3af6578d-4bc4-47ed-8593-ee5ef5f9c842

📥 Commits

Reviewing files that changed from the base of the PR and between e646ce5 and 47d04de.

⛔ Files ignored due to path filters (3)
  • apps/blog/public/rethinking-database-migrations/imgs/hero.png is excluded by !**/*.png
  • apps/blog/public/rethinking-database-migrations/imgs/hero.svg is excluded by !**/*.svg
  • apps/blog/public/rethinking-database-migrations/imgs/meta.png is excluded by !**/*.png
📒 Files selected for processing (1)
  • apps/blog/content/blog/rethinking-database-migrations/index.mdx

Align the new migrations article with review feedback by using jsonc for commented snippets, securing the Discord link with https, and tightening repeated phrasing.

Made-with: Cursor
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