Skip to content

copy(compute): align landing page copy with messaging skills + SEO#7929

Open
ankur-arch wants to merge 3 commits into
feat/DR-8328-compute-pagefrom
copy/DR-8328-compute-page-messaging
Open

copy(compute): align landing page copy with messaging skills + SEO#7929
ankur-arch wants to merge 3 commits into
feat/DR-8328-compute-pagefrom
copy/DR-8328-compute-page-messaging

Conversation

@ankur-arch
Copy link
Copy Markdown
Contributor

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

Editorial and SEO pass on the Compute landing page copy, aligned with our internal product-messaging and copy-review guidelines. Targets feat/DR-8328-compute-page so it can be reviewed alongside the page.

What changed

Voice and style

  • Removed em dashes from user-facing copy (hero, meta, feature bullets, comparison benefits, How-it-works tabs), per our style guide.
  • Tightened fragmented lines into clear sentences: Push code. It runs. to Push code, it runs. plus a concrete clause; combined the WebSockets/streaming lines on the Hono card.
  • Removed repetition (Automatic scaling, automatic recovery, automatic handling of OOM conditions to Automatic scaling, recovery, and OOM handling).

Clarity

  • Replaced abstract phrasing with concrete copy:
    • Compute keeps it all together. to One service for your app, assets, and jobs.
    • No runtime constraints. to not a constrained edge runtime
    • ultra-low latency to low-latency access; grows into jobs to for APIs and background jobs.
  • Hero and meta now describe how it works (long-lived process on Bun) rather than listing workload nouns.
  • "Why we built Compute" reframed around the integrated-platform story: one workflow instead of separate build, hosting, and database tools.
  • Fixed a broken in-page reference (the AI-agent card pointed to a section that does not exist).

SEO

  • Page title and OG title now lead with the primary keyword phrase ("Deploy TypeScript apps to production") and match the H1.
  • Meta description tightened to ~150 characters.
  • OG image alt text made descriptive.

Note for reviewers

A few product specifics on the page (pricing, performance characteristics, and stage of some capabilities) are worth a final confirmation from the Compute team before publish. I can adjust wording once those are confirmed.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Updated marketing copy describing TypeScript workloads and database features
    • Revised SEO metadata including page title and social media descriptions
    • Updated UI text, headings, and benefit descriptions across the Compute section

Apply the Prisma communication skills (prisma-copy-review +
prisma-product-messaging) to the Compute landing page copy.

- Remove all em dashes from user-facing copy (page hero/meta, feature
  bullets, comparison card benefits, How-it-works tabs).
- Cut fluff and vague intensifiers: "actually", "ultra-low latency",
  "grows into jobs", and the "felt as good as the code" line, which is
  reframed around the integrated-platform narrative from the
  positioning doc (fewer separate build/hosting/database tools).
- Replace dramatic fragments ("Push code. It runs.", "Sockets stay
  open. Streams flow uninterrupted.") with single workflow sentences,
  and name the mechanism (long-lived process on Bun) in the hero/meta.
- Fix a broken cross-reference ("See the AI workloads section above" —
  no such section exists).
- Mark capabilities not yet covered by the Compute docs as "Coming
  soon": co-located database (feature card + bento + How-it-works tab)
  and reliability automation (auto scaling/recovery/OOM).

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

vercel Bot commented Jun 2, 2026

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

Project Deployment Actions Updated (UTC)
blog Ready Ready Preview, Comment Jun 2, 2026 1:13pm
docs Ready Ready Preview, Comment Jun 2, 2026 1:13pm
eclipse Ready Ready Preview, Comment Jun 2, 2026 1:13pm
site Ready Ready Preview, Comment Jun 2, 2026 1:13pm

Request Review

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Jun 2, 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: 6d125e15-871f-456a-87b3-5b5227ae5368

📥 Commits

Reviewing files that changed from the base of the PR and between af5314d and 12902eb.

📒 Files selected for processing (1)
  • apps/site/src/app/compute/page.tsx
🚧 Files skipped from review as they are similar to previous changes (1)
  • apps/site/src/app/compute/page.tsx

Walkthrough

This PR updates marketing copy and SEO across the Compute landing page: template subtitles and benefit text, how-it-works tab punctuation, feature/card descriptions, FAQ entries, hero text, headings, and page metadata.

Changes

Compute landing page copy & metadata

Layer / File(s) Summary
Component templates and benefits
apps/site/src/app/compute/components.tsx
Hono API template subtitle and Prisma Compute self-hosting benefit strings are reworded.
How-it-works tab copy
apps/site/src/app/compute/how-it-works.tsx
Co-Located tab description punctuation changed from an em dash to a comma.
Feature descriptions and cards
apps/site/src/app/compute/page.tsx
"Any TypeScript workload" text refined; Co-located database feature and card descriptions (DB connected by default, Reliable by design) updated and shortened.
FAQ: Does it work for me?
apps/site/src/app/compute/page.tsx
FAQ entries rewritten to clarify WebSockets/streaming continuity, background jobs/workers, and AI agent sandbox scenarios.
SEO metadata, hero, headings, footer
apps/site/src/app/compute/page.tsx
generateMetadata title/description/OG description updated; OG image alt text adjusted; hero subtitle, section headings, and footer paragraph copy revised.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title directly describes the main change: copy edits to align the Compute landing page with messaging guidelines and SEO best practices, which matches the PR objectives and file changes.
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.

@argos-ci
Copy link
Copy Markdown

argos-ci Bot commented Jun 2, 2026

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

Build Status Details Updated (UTC)
default (Inspect) ⚠️ Changes detected (Review) 1 changed Jun 2, 2026, 1:19 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: 3

🤖 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/site/src/app/compute/how-it-works.tsx`:
- Line 1259: Update the title string so the punctuation around the parenthetical
is correct: in the object that defines the title property (the "title" key in
apps/site/src/app/compute/how-it-works.tsx), remove the period before "(Coming
soon)" and place punctuation appropriately—e.g., change "Database right next to
your code. (Coming soon)" to "Database right next to your code (Coming soon)".
Ensure only the title value is modified.

In `@apps/site/src/app/compute/page.tsx`:
- Around line 117-130: The "Works with any database, no lock-in" bullet in the
list conflicts with the co-location claim (co-location is specific to Prisma
Postgres); update the copy in the list (the <li> containing "Works with any
database, no lock-in") to clearly scope the capability to Prisma Postgres (e.g.,
mention "Prisma Postgres co-location" or remove the "any database" phrase) so
the bullets don't imply same-region automatic co-location for all databases;
keep the Badge and subhead as-is and ensure the revised text appears alongside
the other list items in the same <ul> block.
- Around line 171-176: The AI-agent card object titled "Building an AI agent?"
is incorrectly signaling availability via badgeColor: "ppg" while other
co-location items are marked "Coming soon"; update that card's availability to
match by changing its badge status (the badgeColor property on the "Building an
AI agent?" card) to the same "coming soon" token used for "Co-located
database"/"DB connected by default" or alternatively remove/soften the
"co-located memory" claim in the description so the badge and copy consistently
read "Coming soon".
🪄 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: 574f43ad-5df1-4a74-87aa-ec25befe12e2

📥 Commits

Reviewing files that changed from the base of the PR and between 7b0a394 and d4b7561.

📒 Files selected for processing (3)
  • apps/site/src/app/compute/components.tsx
  • apps/site/src/app/compute/how-it-works.tsx
  • apps/site/src/app/compute/page.tsx

Comment thread apps/site/src/app/compute/how-it-works.tsx Outdated
Comment thread apps/site/src/app/compute/page.tsx Outdated
Comment thread apps/site/src/app/compute/page.tsx
Drop the "Coming soon" markers and tighten remaining empty language,
plus SEO fields.

- Remove "Coming soon" badges/label (co-located feature card, two
  bento cards, How-it-works tab).
- Empty/slogan language replaced with concrete claims:
  - "Compute keeps it all together." -> "One service for your app,
    assets, and jobs." (matches the comparison cards below it)
  - "No runtime constraints." -> "not a constrained edge runtime"
- SEO: page title and OG title now carry the primary keyword phrase
  ("Deploy TypeScript apps to production") instead of the bare brand
  name; meta description tightened under ~155 chars; OG image alt made
  descriptive.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@ankur-arch ankur-arch changed the title copy(compute): align landing page copy with messaging skills copy(compute): align landing page copy with messaging skills + SEO Jun 2, 2026
The "Building an AI agent?" card carried a green YES badge while
claiming "co-located memory", which reads as an availability promise
for the database co-location story. Reword to "in-process memory",
which describes the long-lived stateful runtime the page already
presents as available, so the card no longer implies co-location
availability.

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