Skip to content

docs(docs): label the Accelerate URL forms correctly in the Console retirement warning - #8226

Merged
sneub merged 1 commit into
mainfrom
prisma/console-accelerate-url-labels
Sep 8, 2026
Merged

docs(docs): label the Accelerate URL forms correctly in the Console retirement warning#8226
sneub merged 1 commit into
mainfrom
prisma/console-accelerate-url-labels

Conversation

@prisma-robot

@prisma-robot prisma-robot Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Overview

This lands the one-line fix from #8220's round-2 review, which was pushed to that PR's branch (ecc2c30bbe563f44aba3bd129dab75d9e0b6bd76) three minutes after the PR was merged at its round-1 head. The commit is cherry-picked onto current main unchanged.

What it delivers

console/getting-started.mdx, the :::warning[Accelerate retirement] block in Step 6, called prisma://accelerate.prisma-data.net/?api_key=… a "hosted Accelerate connection for Prisma Postgres". That is the wrong product:

  • prisma://accelerate.prisma-data.net/?api_key=… is the standalone Accelerate environment form — see accelerate/getting-started.mdx (line 47), and it is what the "For Accelerate" resource in Step 4 of this same page creates.
  • prisma+postgres://accelerate.prisma-data.net/?api_key=… is the hosted Prisma Postgres form — see postgres/database/switch-from-accelerate.mdx (lines 9 and 24).

The warning links to two different migration paths, so a reader matching their own connection string against the label was being pointed at the wrong one. The sentence now names both forms and ties each to its product. Nothing else changed; the diff is one line.

How I tested it

From apps/docs, on this branch (branched from main at a687e6f, no merge needed):

  • pnpm lint:links — 687 files, 0 errors
  • pnpm lint:spellcheck — 826 files, 0 issues
  • pnpm test:llm-markdown — 9/9 snapshots pass
  • pnpm lint:images — clean
  • pnpm lint:agent-ready — 0 failures, 0 warnings
  • pnpm test — 7/7 pass
  • pnpm lint:code — 6307 total, byte-identical to the baseline with main's version of the file restored; the page's single pre-existing "missing title" warning is unchanged

I also re-derived the finding from the source pages rather than trusting the review comment, which is where the accelerate/getting-started.mdx and switch-from-accelerate.mdx line references above come from.

Assumptions and decisions

Follow-ups noticed, left alone

…etirement warning

The warning called `prisma://accelerate.prisma-data.net/?api_key=...` a hosted
Accelerate connection for Prisma Postgres. That form belongs to standalone
Accelerate environments (the Step 4 resource); hosted Prisma Postgres uses
`prisma+postgres://accelerate.prisma-data.net/?api_key=...`, as documented in
postgres/database/switch-from-accelerate. Name both forms so a reader can tell
which retirement path applies.

Refs: #8218
@vercel

vercel Bot commented Sep 8, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated
blog Ready Ready Preview Sep 8, 2026 12:03pm UTC
docs Ready Ready Preview Sep 8, 2026 12:03pm UTC
eclipse Ready Ready Preview Sep 8, 2026 12:03pm UTC
site Ready Ready Preview Sep 8, 2026 12:03pm UTC

Request Review

@github-actions

github-actions Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

🍈 Lychee Link Check Report

8 links: ✅ 1 OK | 🚫 0 errors | 🔀 0 redirects | 👻 7 excluded

✅ All links are working!


Full Statistics Table
Status Count
✅ Successful 1
🔀 Redirected 0
👻 Excluded 7
🚫 Errors 0
⛔ Unsupported 0
⏳ Timeouts 0
❓ Unknown 0

@prisma-robot

prisma-robot Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor Author

Review clean at 32fc0ca

What it does. One prose line in apps/docs/content/docs/console/getting-started.mdx: the Step 6 :::warning[Accelerate retirement] block previously labelled prisma://accelerate.prisma-data.net/?api_key=… as a hosted Prisma Postgres connection. It now names both forms and ties each to its product: prisma://… for the Accelerate environments created in Step 4, prisma+postgres://… for hosted Prisma Postgres. The two migration links below it are unchanged.

What I checked.

  • The relabelling is correct against the sources: accelerate/getting-started.mdx documents prisma://accelerate.prisma-data.net/?api_key=… as the Accelerate environment string, and postgres/database/switch-from-accelerate.mdx documents prisma+postgres://accelerate.prisma-data.net/?api_key=… as the hosted Prisma Postgres form. Step 4's "For Accelerate" subsection on this same page does create an environment, so the cross-reference is accurate.
  • Both linked pages exist with matching url: frontmatter.
  • The file at head is byte-identical to ecc2c30b, the round-2 fix from docs(docs): replace hosted Accelerate connections in the Netlify, viewing-data and Console guides #8220 that missed that PR's merge; the branch is 0 behind main.
  • Gates from apps/docs, run here: lint:links 687 files / 0 errors, lint:spellcheck 826 files / 0 issues, test 7/7, test:llm-markdown 9/9, lint:images clean, lint:code 6307 (unchanged; the diff touches no code fences). types:check/build not applicable per apps/docs/CLAUDE.md.
  • No harness attribution in the commit.

Risk: low. A single-sentence prose correction to a page that already carried the warning; it changes no links, code, structure, or navigation, and it makes the warning match the two pages it points at.

Follow-ups. The PR body already proposes the Step 4 "For Accelerate" retirement-notice gap as a task, so I did not re-propose it. The stale 127.0.0.1 screenshots in guides/postgres/viewing-data.mdx need new captures, not a code change; agreed that stays a note.

— reviewer

@sneub
sneub merged commit c8a7fa8 into main Sep 8, 2026
16 checks passed
@sneub
sneub deleted the prisma/console-accelerate-url-labels branch September 8, 2026 13:15
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