[artugrande]

The hole, and the fix

The pages wrote Tether's two dollar tokens as USDT and USAT in prose. The maintainer review on #2415 asks for USD₮ and USA₮, the issuers' own spelling, and #2432 writes that rule into AGENTS.md §7. Ten pages on main already follow it, so the site used both spellings, sometimes on the same page. For example, build/fee-abstraction/using-fee-abstraction.mdx:60 read "USDC, USDT, or USA₮".

This PR changes 55 prose lines in 20 pages to USD₮ and USA₮. It changes only prose. The script skips fenced code blocks, inline code, link targets and URLs, so CLI flags, addresses, symbol() values, link URLs and code samples are untouched. No heading changed, so no anchor moved.

Per file:

Page	Lines
learn/ramps.mdx	12
build/fee-abstraction/using-fee-abstraction.mdx	9
build/agents/askbots.mdx	6 (includes the description, so the llms.txt line changes too)
build/mini-apps/overview.mdx	5 (includes the Token column of the address table)
build/agents/overview.mdx	3
operate/specification/fee-abstraction.mdx	3
build/fee-abstraction/overview.mdx, build/nightfall.mdx, learn/protocol/index.mdx	2 each
attribution-tags, self-agent-id, usecases, build-with-self, build-with-usat, ethers/index, web3/index, bridged-tokens/bridges, learn/celo, protocol/transactions/overview, learn/wallets	1 each

What this does NOT do / residual risk

• One line kept on purpose: build/agents/mcp/celo-mcp.mdx:114. It lists the symbols the Celo MCP server's built-in token table reports (USDC, USDT, USDGLO, cKES, …), and the same sentence explains that those are the server's own labels. Changing it would misstate what the tool returns.
• cUSD is not touched: ethers/index.mdx:9 and web3/index.mdx:20 still say "cUSD", the old name for USDm. That is a different rename and is out of scope here.
• Product names stay as they are: USDT0 in learn/bridged-tokens/bridges.mdx is unchanged. Only the two prose mentions of the token itself changed.

Judgement calls

• learn/ramps.mdx: the 12 lines are the "Currency" lists for each ramp provider. These lists already use Celo-docs naming (USDm, not the providers' own labels), so they follow the docs spelling. If a maintainer wants provider pages to mirror each provider's own label instead, reverting is one line per block.
• The askbots.mdx description: it changes the text that llms.txt shows AI tools. It still names the same token.

Issues

Closes #2431
Refs #2427, #2432, #2415

Every box in #2431 is met. The only line the re-run scan still reports is celo-mcp.mdx:114, which is kept with the reason above. mint broken-links passes, and no heading changed.

Stacking / conflicts

• Branched off main (61b9bea). Independent of docs(agents-md): write USD₮ and USA₮ in prose, keep literal values as-is #2432: that PR changes only AGENTS.md, and this one changes only pages. Either can merge first.
• docs(agents): add buy page for paying x402 APIs from an agent #2425 conflicts textually on build/agents/overview.mdx:74, the AskBots sentence, because docs(agents): add buy page for paying x402 APIs from an agent #2425 adds serial commas to that same line. git merge-tree confirms the conflict. docs(x402): add a guide for adding Celo to an existing endpoint #2420 merges cleanly. The resolution keeps both changes:

  AskBots is a product built by the Celo team together with an AI agent, where builders pay AI agents in USD₮ to review a website, API, MCP server, skill file, or Mini App, and where agent developers can run an agent that earns USD₮ for accepted reviews.

Verification evidence

On this head (3a44475), with the CI-pinned mintlify@4.2.920:

• mintlify validate: success build validation passed
• mintlify broken-links --check-redirects: success no broken links found
• bash scripts/check-orphans.sh: No orphan pages found.
• python3 -m unittest discover -s scripts -p 'test_*.py': OK
• python3 scripts/check_redirects.py: No redirect problems found.

The scan from #2431 (prose outside fenced code, inline code and URLs) found 56 lines before this change. Re-run on this head, it finds 1, celo-mcp.mdx:114, which is kept. git diff adds no heading, no JSX attribute, and no new "No newline at end of file".

Remaining ops steps

• none

Checklist

• Title is the commit message I want on main
• Judgement calls flagged above
• Docs checks pass locally on the current head
• Re-read acceptance criteria of every Closes issue — all met
• No secrets in the diff
• Questions for the maintainer: keep the ramp provider lists in docs spelling, or mirror each provider's own label?

🤖 Generated with Claude Code

[artugrande]

@benibauer3, could you review this? It is the prose sweep from #2431: 55 lines across 20 pages now say USD₮/USA₮, following the AGENTS.md rule in #2432. Code, links and on-chain symbols are untouched, and one line (celo-mcp.mdx:114) is kept on purpose. It conflicts with #2425 on one line of build/agents/overview.mdx, and the resolved line is in the body. The open question for a maintainer is at the end: should the ramp provider lists use docs spelling, or each provider's own label?

🤖 Generated with Claude Code

[benibauer3]

@GigaHierz, @palango: could one of you approve this one? My GitHub token cannot approve in this repo, so this is my review as a comment. Looks good to approve. Checked at 3a44475, against base 61b9bea.

• All 55 changed lines differ from the base only by USDT→USD₮ or USAT→USA₮. No code, inline code, link target or URL changed, and no heading moved.
• The re-run scan finds one prose line left: celo-mcp.mdx:114, kept on purpose because it lists the Celo MCP server's own token labels. Agreed.
• The overview.mdx:74 conflict with docs(agents): add buy page for paying x402 APIs from an agent #2425 is the only overlap I found, and the resolution in the body keeps both changes.

On the open question in the body: I would keep the ramp "Currency" lists in docs spelling, since they already use USDm and not each provider's label.

Non-blocking, for Lena: people searching for "USDT" will no longer match these prose lines. Consider whether one canonical page should say "USD₮ (often written USDT)" once, so search still finds it. Since the #2432 rule bans USDT in prose, that call is yours.