Skip to content

docs: copy improvements across landing, overview, FAQ, and quickstart#317

Merged
brendanjryan merged 4 commits into
mainfrom
docs/copy-improvements
Mar 14, 2026
Merged

docs: copy improvements across landing, overview, FAQ, and quickstart#317
brendanjryan merged 4 commits into
mainfrom
docs/copy-improvements

Conversation

@brendanjryan

@brendanjryan brendanjryan commented Mar 14, 2026

Copy link
Copy Markdown
Collaborator

Addresses copy feedback:

# Change
6 'Multi rail'/'Multi currency' → plain English
8 x402 comparison → table in FAQ
9 Remove duplicate 'What is MPP?' FAQ
10 'Why build MPP on Tempo?' acknowledges other rails first
12 Remove zero-value 'Can any Agent use MPP?' FAQ
13 Manual mode → 'Advanced: manual mode'
15 'Monetize your API' → 'Add payments to your API'
16 Remove 'internet-native' (4 instances)
17 Standardize voice, remove jargon
19 'inline' → 'in the same HTTP request'
20 Add // pathUSD on Tempo comment on first hex address
21 'in the same HTTP request/response' language throughout

Sidebar casing (sentence case per style guide):

  • Accept One-Time Payments → Accept one-time payments
  • Accept Pay-As-You-Go Payments → Accept pay-as-you-go payments
  • Accept Streamed Payments → Accept streamed payments
  • Getting Started → Getting started
  • Client/Server/Middleware/Core/CLI Reference → lowercase 'reference'
  • Core Types → Core types (Python + Rust)

@vercel

vercel Bot commented Mar 14, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
mpp Ready Ready Preview, Comment Mar 14, 2026 10:28pm

Request Review

…ar shake

- Fix logo SVG viewBox clipping on Safari by adding 0.5px padding
- FAQ: proper noun style for 'What is MPP?', add cards/Lightning to stablecoin Q, strengthen x402 comparison, cross-ref paymentauth.org
- Agent quickstart: remove 'coding' from tagline
- Protocol page: consolidate 5 spec cards to 4 (even grid) to fix orphan card padding
- Sidebar: add contain: inline-size to prevent font-swap shake on reload
- Overview: add missing comma in 'simple, extensible core'
Comment thread src/pages/faq.mdx Outdated
| | **MPP** | **x402** |
|---|---------|----------|
| **Payment methods** | Stablecoins, cards, wallets, custom rails | Blockchain only |
| **Production primitives** | Idempotency, expiration, request-body binding, tampering mitigations | Limited |

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

keep this as text -- undo table

- Replace 'Monetize your API' with 'Add payments to your API' everywhere
- Remove 'internet-native' (4 instances) — replace with specific language
- Replace 'inline' with 'in the same HTTP request/response' in user-facing pages
- Replace 'Multi rail'/'Multi currency' with plain English descriptions
- Convert x402 comparison from bullet list to comparison table in FAQ
- Rewrite 'Why build MPP on Tempo?' to acknowledge other rails first
- Remove duplicate 'What is MPP?' FAQ (already covered in overview)
- Remove zero-value 'Can any Agent use MPP?' FAQ
- Rename Manual mode to 'Advanced: manual mode' in server quickstart
- Add '// pathUSD on Tempo' comment on first hex address in server quickstart
- Update sidebar and analytics labels to match
@brendanjryan brendanjryan force-pushed the docs/copy-improvements branch from f4c9293 to 7285a32 Compare March 14, 2026 22:27
@brendanjryan brendanjryan merged commit bcea058 into main Mar 14, 2026
8 checks passed
@brendanjryan brendanjryan deleted the docs/copy-improvements branch March 14, 2026 23:14
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