# Voice

Tempo's personality in words, consistent across every product.

## Overview

Voice is how Tempo sounds in every product: a knowledgeable colleague who explains plainly and wastes no time, as on [tempo.xyz](https://tempo.xyz) and in the [developer docs](https://tempo.xyz/developers). [Tone](/docs/foundations/content/tone) adapts it to each situation, such as a first visit or a failed payment.

## How Tempo Writes

* **Cover Three Points:** State what is happening, what it costs, and what happens next.
* **Define Before Explaining:** Open with one sentence that defines the thing, then list its parts.
* **State Rules as Facts:** State limits and protections as what Tempo enforces, not as warnings.
* **Name Availability Plainly (Testnet only):** Name a stage, such as beta or devnet only, with where it applies and what changes it.
* **State What an Operation Doesn't Do:** State plainly that a refund is a new payment, not a reversal.

## Traits

Each trait names the line it must not cross.

### Clear, Not Simplistic

**Do:** Describe a payment in everyday money words, and format each value with
[Amount](/docs/components/amount) or [Hex](/docs/components/hex).

```tsx
/**
 * Do example for "Clear, Not Simplistic" on the Voice page.
 * Describe a payment in everyday money words, and format each value with Amount or Hex.
 * @module
 */
import { Amount, Hex, ListGroup, style } from '@tempoxyz/ds'

/** Renders the static preview, which the guideline card shows inert. */
export function Demo() {
  return (
    <ListGroup.Root {...styles.rows()}>
      <ListGroup.Row>
        <ListGroup.Label>To</ListGroup.Label>
        <Hex value="0x3c44cdddb6a900fa2b585dd299e03d12fa4293bc" />
      </ListGroup.Row>
      <ListGroup.Row>
        <ListGroup.Label>Amount</ListGroup.Label>
        <Amount symbol="USDC" value="250.00" />
      </ListGroup.Row>
      <ListGroup.Row>
        <ListGroup.Label>Network fee</ListGroup.Label>
        <Amount currency="USD" precise value="0.0003" />
      </ListGroup.Row>
    </ListGroup.Root>
  )
}

namespace styles {
  export const rows = style({ maxWidth: '18rem !custom', width: '100% !custom' })
}
```

**Don't:** Show protocol fields, base units, or gas parameters on a payment review.

```tsx
/**
 * Don't example for "Clear, Not Simplistic" on the Voice page.
 * Don't show protocol fields, base units, or gas parameters on a payment review.
 * @module
 */
import { ListGroup, style } from '@tempoxyz/ds'

/** Renders the static preview, which the guideline card shows inert. */
export function Demo() {
  return (
    <ListGroup.Root {...styles.rows()}>
      <ListGroup.Row>
        <ListGroup.Label>Recipient EOA</ListGroup.Label>
        <span {...styles.value()}>0x3c44cddd…</span>
      </ListGroup.Row>
      <ListGroup.Row>
        <ListGroup.Label>Value</ListGroup.Label>
        <span {...styles.value()}>250000000</span>
      </ListGroup.Row>
      <ListGroup.Row>
        <ListGroup.Label>Gas limit</ListGroup.Label>
        <span {...styles.value()}>21000</span>
      </ListGroup.Row>
    </ListGroup.Root>
  )
}

namespace styles {
  export const rows = style({ maxWidth: '18rem !custom', width: '100% !custom' })

  export const value = style({ typography: 'mono.m1' })
}
```

### Precise, Not Approximate

**Do:** State the exact amount, time, or limit.

```tsx
<Alert>
  <Alert.Icon />
  <Alert.Content>This quote expires in 10 minutes.</Alert.Content>
</Alert>
```

**Don't:** Use vague words such as soon or shortly.

```tsx
<Alert>
  <Alert.Icon />
  <Alert.Content>This quote expires soon.</Alert.Content>
</Alert>
```

### Confident, Not Boastful

**Do:** Confirm the result as a fact, and stop.

```tsx
<Empty.Root>
  <Empty.Icon>
    <Receipt />
  </Empty.Icon>
  <Empty.Title>Payment sent</Empty.Title>
  <Empty.Description>Alice received 25.00 USDC.</Empty.Description>
</Empty.Root>
```

**Don't:** Use hype, hedging, exclamation marks, or emoji for a routine result.

```tsx
<Empty.Root>
  <Empty.Icon>
    <Receipt />
  </Empty.Icon>
  <Empty.Title>Woohoo! 🎉</Empty.Title>
  <Empty.Description>Your lightning-fast payment is on its way!</Empty.Description>
</Empty.Root>
```

### Calm, Not Casual

**Do:** State what failed, and reassure the reader with a fact.

```tsx
<Alert intent="negative">
  <Alert.Icon />
  <Alert.Content>The payment did not go through. Your balance has not changed.</Alert.Content>
</Alert>
```

**Don't:** Joke about a failure that involves money.

```tsx
<Alert intent="negative">
  <Alert.Icon />
  <Alert.Content>Oops! Something broke. Our bad.</Alert.Content>
</Alert>
```

### Respectful, Not Condescending

**Do:** Address the reader as you, and describe the problem and the fix.

```tsx
<Alert intent="negative">
  <Alert.Icon />
  <Alert.Content>This address isn't valid. Check it and try again.</Alert.Content>
</Alert>
```

**Don't:** Blame the reader for an error.

```tsx
<Alert intent="negative">
  <Alert.Icon />
  <Alert.Content>You entered an invalid address.</Alert.Content>
</Alert>
```

### Helpful, Not Pushy

**Do:** Offer the next step plainly, and let the reader decide.

```tsx
<Button variant="secondary">Turn on notifications</Button>
```

**Don't:** Use fear or urgency to drive a choice.

```tsx
<Button variant="secondary">Don't miss out</Button>
```
