Make summaries more consistent (#159)

shreyav · web-flow · commit bbdd279257fc · 2026-02-06T13:04:28.000-08:00
diff --git a/.claude/skills/grid-api/SKILL.md b/.claude/skills/grid-api/SKILL.md
@@ -230,7 +230,7 @@ Internal Account (USD) → External Account (USD)  [transfer-out]
 
 When a user wants to send a payment, guide them through these steps:
 
-### Sending to a UMA Address
+### Sending to an UMA Address
 
 1. Look up the receiver: `node cli/dist/index.js receiver lookup-uma $user@domain.com`
 2. Show supported currencies and any required payer data
diff --git a/.claude/skills/grid-api/references/workflows.md b/.claude/skills/grid-api/references/workflows.md
@@ -8,7 +8,7 @@ This reference describes common payment workflows using the Grid API CLI.
 
 ## Workflow 1: Send Payment to UMA Address
 
-Use this when the user wants to send money to a UMA address like `$alice@example.com`.
+Use this when the user wants to send money to an UMA address like `$alice@example.com`.
 
 ### Steps
 
diff --git a/README.md b/README.md
@@ -149,7 +149,7 @@ The process consists of five main steps:
 
 #### Step 1: Look up recipient UMA address
 
-First, check if a UMA address is valid and retrieve supported currencies and exchange rates.
+First, check if an UMA address is valid and retrieve supported currencies and exchange rates.
 
 ```http
 GET /receiver/$recipient@example.com?userId=9f84e0c2a72c4fa
diff --git a/cli/README.md b/cli/README.md
@@ -303,7 +303,7 @@ node cli/dist/index.js sandbox fund <internalAccountId> --amount 100000
 # Simulate sending funds to a JIT quote
 node cli/dist/index.js sandbox send --quote-id <quoteId> --currency USDC
 
-# Simulate receiving a UMA payment
+# Simulate receiving an UMA payment
 node cli/dist/index.js sandbox receive \
   --uma-address '$user@domain.com' \
   --amount 1000 \
diff --git a/cli/src/commands/receiver.ts b/cli/src/commands/receiver.ts
@@ -30,7 +30,7 @@ export function registerReceiverCommand(
 
   receiverCmd
     .command("lookup-uma <umaAddress>")
-    .description("Look up a UMA address to get payment capabilities")
+    .description("Look up an UMA address to get payment capabilities")
     .option("--customer-id <id>", "Sender customer ID")
     .option("--sender-uma <address>", "Sender UMA address")
     .action(async (umaAddress: string, options) => {
diff --git a/cli/src/commands/sandbox.ts b/cli/src/commands/sandbox.ts
@@ -45,7 +45,7 @@ export function registerSandboxCommand(
 
   sandboxCmd
     .command("receive")
-    .description("Simulate receiving a UMA payment in sandbox")
+    .description("Simulate receiving an UMA payment in sandbox")
     .requiredOption("--uma-address <address>", "Receiver UMA address")
     .requiredOption("--amount <number>", "Amount in smallest unit")
     .requiredOption("--currency <code>", "Currency code")
diff --git a/mintlify/global-p2p/getting-started/platform-configuration.mdx b/mintlify/global-p2p/getting-started/platform-configuration.mdx
@@ -15,7 +15,7 @@ To send and receive using UMA with your own domain (e.g., `$alice@yourdomain.com
 2. Proxy inbound UMA requests to {topLevelProductName}
 3. Define supported currencies and, if you are a regulated institution, the counterparty information you require
 
-If you do not configure a UMA domain, Grid will use the default domain `grid.lightspark.com`.
+If you do not configure an UMA domain, Grid will use the default domain `grid.lightspark.com`.
 
 <Note>You can find more information about the UMA protocol and end user experience at [https://uma.me](https://uma.me).</Note>
 
diff --git a/mintlify/global-p2p/index.mdx b/mintlify/global-p2p/index.mdx
@@ -50,7 +50,7 @@ With real-time funding, you'll receive payment instructions as part of the quote
 ### Sending & Receiving Payments
 To send with {remittanceProductName}, you query recipient information and pricing, then execute and fund a quote. {remittanceProductName} resolves the receiver (by UMA or external bank details), returns min/max and an exchange rate, and provides funding instructions. Once funded, {remittanceProductName} handles FX and delivery to the receiving account.
 
-To receive with {remittanceProductName}, you expose a UMA or supported account identifier. The platform handles conversion and offramping to the receiver’s account currency and notifies you via webhooks so you can credit the customer.
+To receive with {remittanceProductName}, you expose an UMA or supported account identifier. The platform handles conversion and offramping to the receiver’s account currency and notifies you via webhooks so you can credit the customer.
 
 ### Environments
 {remittanceProductName} supports two environments: **Sandbox** and **Production**. 
diff --git a/mintlify/global-p2p/onboarding-customers/invitations.mdx b/mintlify/global-p2p/onboarding-customers/invitations.mdx
@@ -59,7 +59,7 @@ When the invitee clicks the URL, they will be presented with a list of UMA provi
 
 ## Pay-by-Link Invitations
 
-The Grid API supports a "pay-by-link" feature that allows users to create invitations that include a payment amount. This is useful for scenarios where you want to send money to someone who doesn't yet have a UMA address or where the sender doesn't know the receiver's UMA address. They can simply share a link via email, SMS, whatsapp, or other channels to send money.
+The Grid API supports a "pay-by-link" feature that allows users to create invitations that include a payment amount. This is useful for scenarios where you want to send money to someone who doesn't yet have an UMA address or where the sender doesn't know the receiver's UMA address. They can simply share a link via email, SMS, whatsapp, or other channels to send money.
 
 To create a pay-by-link invitation, include the `amountToSend` field when creating the invitation:
 
diff --git a/mintlify/global-p2p/platform-tools/uma-test-wallet.mdx b/mintlify/global-p2p/platform-tools/uma-test-wallet.mdx
@@ -3,7 +3,7 @@ title: "UMA Test Wallet"
 description: "Test UMA payment flows with a real counterparty"
 ---
 
-Grid provides a UMA Test Wallet to help you test UMA payment flows with a real counterparty.
+Grid provides an UMA Test Wallet to help you test UMA payment flows with a real counterparty.
 
 import UMATestWallet from '/snippets/uma-test-wallet.mdx';
 
diff --git a/mintlify/global-p2p/sending-receiving-payments/sending-payments.mdx b/mintlify/global-p2p/sending-receiving-payments/sending-payments.mdx
@@ -5,7 +5,7 @@ This guide covers three methods to send payments:
 
 1. Same-currency transfer to an external account
 2. Cross-currency transfer with a quote
-3. Sending to a UMA address
+3. Sending to an UMA address
 
 ## Choosing the right method
 
diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml
diff --git a/mintlify/snippets/sending/uma.mdx b/mintlify/snippets/sending/uma.mdx
@@ -1,5 +1,5 @@
-## Sending to a UMA Address 
-Send to a UMA address when the receiver is identified by their UMA handle eg $alice@example.com. You'll look up the receiver, create a quote, and then fund.
+## Sending to an UMA Address 
+Send to an UMA address when the receiver is identified by their UMA handle eg $alice@example.com. You'll look up the receiver, create a quote, and then fund.
 
 ### Look up the recipient
 
diff --git a/openapi.yaml b/openapi.yaml
diff --git a/openapi/paths/invitations/invitations.yaml b/openapi/paths/invitations/invitations.yaml
@@ -1,5 +1,5 @@
 post:
-  summary: Create an UMA invitation from a given platform customer.
+  summary: Create an UMA invitation
   description: |
     Create an UMA invitation from a given platform customer.
   operationId: createInvitation
diff --git a/openapi/paths/invitations/invitations_{invitationCode}.yaml b/openapi/paths/invitations/invitations_{invitationCode}.yaml
@@ -1,7 +1,7 @@
 get:
-  summary: Get a specific UMA invitation by code.
+  summary: Get an UMA invitation by code
   description: |
-    Get a specific UMA invitation by code.
+    Retrieve details about an UMA invitation by its invitation code.
   operationId: getInvitation
   tags:
     - Invitations
diff --git a/openapi/paths/receiver/uma/receiver_uma_{receiverUmaAddress}.yaml b/openapi/paths/receiver/uma/receiver_uma_{receiverUmaAddress}.yaml
@@ -1,5 +1,5 @@
 get:
-  summary: Look up a UMA address for payment
+  summary: Look up an UMA address for payment
   description: >
     Lookup a receiving UMA address to determine supported currencies and
     exchange rates.
diff --git a/openapi/paths/transactions/transactions_{transactionId}.yaml b/openapi/paths/transactions/transactions_{transactionId}.yaml
@@ -7,7 +7,7 @@ parameters:
       type: string
 get:
   summary: Get transaction by ID
-  description: Retrieve detailed information about a specific transaction
+  description: Retrieve detailed information about a specific transaction.
   operationId: getTransactionById
   tags:
     - Transactions
diff --git a/openapi/paths/uma_providers/uma_providers.yaml b/openapi/paths/uma_providers/uma_providers.yaml
@@ -1,10 +1,7 @@
 get:
-  summary: This endpoint provides a list of Counterparty Providers that are available.
+  summary: List available Counterparty Providers
   description: |
-    This endpoint provides a list of Counterparty Providers that are available.
-
-    The response includes basic information about each provider, such as its UMA address, name, and supported currencies.
-    This can be used to determine which providers are available for sending or receiving payments.
+    Retrieve a list of available Counterparty Providers. The response includes basic information about each provider, such as its UMA address, name, and supported currencies.
   operationId: getAvailableUmaProviders
   tags:
     - Available UMA Providers
