Add SLA feature page - #380
Conversation
Document Relay's contractual performance commitments, covered metrics, and enterprise qualification flow. Add the page to the Features nav. Linear: MAR-1404
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Claude finished @pedromcunha's task in 3m 54s —— View job Code review: PR #380 — Add SLA feature page
Reviewed 1. Placement: this reads like a
|
| This PR | Existing page |
|---|---|
slas.mdx:18 — "quote latency at p50, p95, and p99 for each route category" (no values) |
solutions/wallets-and-wallet-providers.mdx:20 — "p50 fill time … less than 3 seconds" |
slas.mdx:19 — "success-rate commitments up to 99.9%" |
solutions/payment-service-providers.mdx:58 — "99.9%+ fill success with sub-3-second settlement" |
As written, the page that is supposed to harden these numbers into commitments states them more weakly than the pages that market them. "Up to 99.9%" also reads as a ceiling rather than a floor, which is the opposite of how an SLA target works. Worth reconciling so the two don't contradict. Fix this →
5. Zero internal links (§2.6)
§2.6: "When introducing a concept that has its own page, link on first mention." The page names covered chains, quotes, fills, deposit-through-settlement, and four audience segments — and links to nothing in-repo. Its only two links are the unverified status page and a mailto. Concrete candidates: /resources/supported-chains for covered chains, /features/fast-fill for fill speed, and the /solutions/* pages for the audience bullets on lines 50–52. Fix this →
6. Three existing pages already talk about SLAs and none link here
§4.1 asks a draft to flag companion surfaces. These are them — each carries a **SLAs & Customer Support** benefit block that is now the reader's first mention of a concept with a dedicated page:
solutions/multichain-apps.mdx:22solutions/wallets-and-wallet-providers.mdx:22solutions/chains.mdx:18
Also worth a look: solutions/payment-service-providers.mdx:58 and solutions/commerce-and-payments.mdx:79 make reliability claims that this page now formalizes. Fix this →
7. "four metric families" but five metrics listed
slas.mdx:14 says four; the list at lines 16–19 names five, because line 19 bundles fill latency and fill success into one bullet. Split the bullet and say five, or drop the count. Fix this →
Minor
Filename. features/slas.mdx is the only acronym filename in the folder — every sibling spells words out (fast-fill, price-stabilization, gasless-execution). service-level-agreements.mdx would match both the folder convention and the title, and this URL is the kind of thing that gets pasted into a procurement doc. Cheaper to change now than after indexing. Fix this →
Contact address. mailto:support@relay.link (line 55) is consistent with existing practice (security/bounties.mdx:174, references/api/api_resources/supported-chains.mdx:22), so no style issue. But this page routes enterprise agreement and procurement inquiries there — if a sales/BD alias exists, that's probably the better target.
Contractual language. Lines 6, 18, and 19 use binding phrasing ("contractual performance commitments," "Relay commits to") with specific numeric targets. Worth a legal/BD read before publish, since a docs page can set expectations independent of what any given enterprise agreement actually says. Outside what I can assess from the repo.
What's correct
- Frontmatter matches §2.1; no
#in body;##/###depth respected (§2.2). - Paragraphs within the 2–3 sentence cap (§2.10); no italics; bold used per the established lead-in pattern (§2.9).
- Horizontal rules separating major sections, which §2.5 specifies for feature guides.
- No callouts, so the 15-line cap and nesting rules aren't at issue.
docs.jsonaddition is well-formed and correctly placed in the Features group.
I did not make any changes — this was a review only. Note that findings 2 and the contractual-language item need product/legal input rather than an edit.
· Branch
Implements MAR-1404: Create SLA Product Marketing
What this changes
How I verified
git diff-tree --check HEAD^docs.jsonand confirmed thefeatures/slasnavigation entry.Open questions
🤖 Opened by Scout (autonomous). Ready for human review.
Linear: https://linear.app/relayprotocol/issue/MAR-1404/create-sla-product-marketing