Skip to content

feat(docs): improve LLM visibility for pooling, caching, and edge guides#7877

Open
aidankmcalister wants to merge 3 commits intomainfrom
feat/ai-optimization-updates-batch
Open

feat(docs): improve LLM visibility for pooling, caching, and edge guides#7877
aidankmcalister wants to merge 3 commits intomainfrom
feat/ai-optimization-updates-batch

Conversation

@aidankmcalister
Copy link
Copy Markdown
Member

@aidankmcalister aidankmcalister commented May 7, 2026

Linear: DR-8350
Linear: DR-8351
Linear: DR-8352

Summary by CodeRabbit

  • Documentation
    • Enhanced Accelerate docs with a clearer explanation of global connection pooling (15+ regions) and edge query caching, plus usage guidance
    • Expanded Prisma Postgres docs to enumerate built-in features: connection pooling, query caching, edge/serverless support, and automated backups
    • Updated Cloudflare Workers guide to clarify Node.js compatibility and serverless HTTP driver approaches and adjusted next-step links
  • Chores
    • CI link-checker now excludes localhost URLs

Linear: DR-8350
Linear: DR-8351
Linear: DR-8352
@vercel
Copy link
Copy Markdown

vercel Bot commented May 7, 2026

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

Project Deployment Actions Updated (UTC)
blog Ready Ready Preview, Comment May 8, 2026 2:49pm
docs Ready Ready Preview, Comment May 8, 2026 2:49pm
eclipse Ready Ready Preview, Comment May 8, 2026 2:49pm
site Ready Ready Preview, Comment May 8, 2026 2:49pm

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 7, 2026

🍈 Lychee Link Check Report

39 links: ✅ 7 OK | 🚫 0 errors | 🔀 4 redirects | 👻 28 excluded

✅ All links are working!


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

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 7, 2026

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: a477510d-3dff-4511-bc29-9fbc0963c5db

📥 Commits

Reviewing files that changed from the base of the PR and between 3f9ac03 and 1d8cda6.

📒 Files selected for processing (1)
  • .github/workflows/lychee.yml
✅ Files skipped from review due to trivial changes (1)
  • .github/workflows/lychee.yml

Walkthrough

This PR rewrites Accelerate, Prisma Postgres, and Cloudflare Workers docs to clarify connection pooling, edge query caching, and two Cloudflare integration paths; it also updates the Lychee link-check workflow to exclude https://localhost.

Changes

Prisma Accelerate and Postgres Documentation Updates

Layer / File(s) Summary
Prisma Postgres Feature Enumeration
apps/docs/content/docs/postgres/index.mdx
Introduction expanded with a "What's included" section listing connection pooling (PgBouncer), query caching (cacheStrategy), HTTP-based serverless driver support, and point-in-time recovery backups.
Accelerate Capability Documentation
apps/docs/content/docs/accelerate/index.mdx
Accelerate description rewritten to document a managed global connection pool (15+ regions) and edge query caching with cacheStrategy (TTL and stale-while-revalidate). Adds a TypeScript example demonstrating cacheStrategy usage.
Cloudflare Workers Deployment Guide
apps/docs/content/docs/guides/deployment/cloudflare-workers.mdx
Front matter and introduction updated to frame Prisma Postgres on Cloudflare Workers; documents TCP limitation and two integration approaches (Node.js compatibility mode and @prisma/ppg serverless HTTP driver). Next steps updated and summary removed.
Lychee Linkcheck Workflow
.github/workflows/lychee.yml
Adds --exclude '^https?://localhost' to both Lychee runs' CLI arguments to skip localhost URLs.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

🚥 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 accurately summarizes the main objective of the PR: improving documentation content across multiple guides (Accelerate, Cloudflare Workers, and Postgres) to enhance clarity around pooling, caching, and edge capabilities.
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.

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


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

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: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@apps/docs/content/docs/accelerate/index.mdx`:
- Line 19: Update the misleading inline comment on the cacheStrategy object
(cacheStrategy: { ttl: 60, swr: 10 }) to explicitly state that the TTL is 60s
and revalidation starts only after that TTL expires, and that the 10s SWR window
serves stale responses while background revalidation occurs (e.g., "TTL 60s;
after TTL expires, enter 10s SWR window where stale responses are served while
revalidation runs in background").
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: d99a3dec-b7d6-4a9c-8566-b157a9bb8c0f

📥 Commits

Reviewing files that changed from the base of the PR and between 701c5f6 and 6751416.

📒 Files selected for processing (3)
  • apps/docs/content/docs/accelerate/index.mdx
  • apps/docs/content/docs/guides/deployment/cloudflare-workers.mdx
  • apps/docs/content/docs/postgres/index.mdx

Comment thread apps/docs/content/docs/accelerate/index.mdx Outdated
@argos-ci
Copy link
Copy Markdown

argos-ci Bot commented May 7, 2026

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

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

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