# Voice — Full rules

## Grammatical person

Always second person singular with tuteo. For every market without exception, Argentina included.

✅ "Puedes", "haz", "configura", "revisa"
❌ "Podés", "hacé" (voseo) / "Usted puede" (formal) / "El usuario puede..." (third person)

| Context | Correct | Incorrect |
|---|---|---|
| Instruction | "Revisa tus notificaciones" | "Revise sus notificaciones" |
| Instruction | "Puedes configurar tu perfil" | "Podés configurar tu perfil" |
| Confirmation | "Tu solicitud fue enviada" | "La solicitud del usuario fue enviada" |

## Active voice

Default to active voice. The subject performs the action.

✅ "Te enviamos una notificación." / "Procesamos tu solicitud."
❌ "Una notificación fue enviada." / "Tu solicitud fue procesada."

**Valid exception:** Passive voice when the agent is irrelevant or unknown.
✅ "Tu contraseña fue actualizada." / "Este campo es obligatorio."

## Gender and neutrality

Avoid gender marks whenever possible.

Strategies:
- Collective nouns: "el equipo", "las personas", "tu cuenta"
- Genderless nouns: "colaboradores", "responsable", "titular"
- Reformulations: "la persona" or "quien trabaja en..." instead of "el empleado/la empleada"

Do not use: slashes (colaborador/a), at-signs (colaborador@s), "x" (colaboradorxs)

**Rule of thumb:** If it sounds forced or confusing, generic masculine is preferable to sacrificing clarity.
✅ "Todos los colaboradores tienen acceso." / "Cada persona del equipo tiene acceso."
❌ "Todos/as los/as colaboradores/as tienen acceso."

## Neutral Spanish — regionalisms to avoid

| Avoid | Neutral alternative | Region |
|---|---|---|
| Pibe / piba | Persona, compañero | Argentina |
| Tío / tía | Compañero, colega | Spain |
| Güey / wey | (omit) | Mexico |
| Chamba | Trabajo | Mexico, Peru |
| Laburo | Trabajo | Argentina |
| Plata | Dinero, remuneración | Argentina, Colombia |
| Jalar | Trabajar | Peru |
| Currar | Trabajar | Spain |
| Mola | Funciona bien, es útil | Spain |
| Bacán / chévere | Genial, excelente | Colombia, Peru, Chile |
| Nomás | Solamente, solo | Mexico |
| Parce | Compañero, colega | Colombia |
| Coger (tomar) | Tomar, agarrar | Spain |
| Ordenador | Computadora | Spain |

## Diminutives

**Allowed** in onboarding, celebration, or informal messages:
✅ "Un pasito más y listo." / "Tu equipito ya está creciendo."

**Forbidden** in errors, legal terms, destructive actions, or formal contexts:
❌ "Hubo un problemita con tu solicitud." / "¿Quieres eliminar este archivito?"

## Punctuation

**Final periods in UI:**
- Titles and headings: no period
- Body text and paragraphs: with period
- Short tooltips: no period
- Error, success, or empty-state messages: with period
- Form labels: no period
- Placeholders: no period

**Capitalization:** Only first letter of a sentence (sentence case). Product features lowercase.
✅ "Solicitudes pendientes" / "Puedes ver el estado desde el dashboard"
❌ "Solicitudes Pendientes" / "Puedes ver el Estado desde el Dashboard"

**Exclamation marks:**
- Max 1 per screen or text
- Only in achievements, celebrations, or welcomes
- Never in errors, alerts, or destructive actions

✅ "Tu perfil está completo. ¡Bienvenido a Humand!"
❌ "¡Tu perfil está completo! ¡Bienvenido a Humand!"

## Numbers and dates

**Date:** DD/MES/AAAA where MES is the 3-letter uppercase month abbreviation.
✅ 22/ENE/2026 / 03/MAR/2026 / ❌ 22/01/2026

**Numbers:**
- Thousands separator: period → 1.500
- Decimal separator: comma → 85,5
- Percentages: no space → 85%
- Currency: symbol attached → $1.500

## CTAs (call to action)

Verb in infinitive or imperative (tuteo) + object when needed. Max 3 words.

| Context | Correct | Incorrect |
|---|---|---|
| Save data | "Guardar" | "Haga clic para guardar" |
| Download file | "Descargar reporte" | "Haga clic aquí" |
| Send request | "Enviar solicitud" | "Continuar con el proceso" |
| View detail | "Ver detalle" | "Ver más información" |
| Confirm action | "Confirmar" | "Sí, estoy de acuerdo" |
| Cancel | "Cancelar" | "No, volver atrás" |
| Destructive action | "Eliminar" | "Borrar todo" |
| Email | "Revisa tu reporte" | "Ante cualquier duda..." |

**In emails:** One single CTA per email, in imperative. ✅ "Descarga", "Revisa", "Responde"

## Maximum lengths

| Component | Limit |
|---|---|
| Title / heading | 50 characters |
| Subtitle | 80 characters |
| Body text | 150 characters per block |
| Tooltip | 80 characters |
| Push notification (title) | 60 characters |
| In-app notification | 120 characters |
| Placeholder | 40 characters |
| Label | 30 characters |
| Error message | 120 characters |
| Success message | 100 characters |
| CTA / button | 20 characters (3 words) |
| Loading state | 50 characters |
| Banner | 150 characters |
| Onboarding body | 120 characters |

## Never

- Empty corporate jargon: "sinergia", "apalancar", "solución end-to-end"
- Passive phrases that dilute responsibility: "Se ha producido un error"
- Unfounded superlatives: "increíble", "la mejor plataforma"
- More than one exclamation mark per text
- "Recursos" to refer to people
- Voseo in any market
