# Tone — Reference by context

Tone adapts to context. What never changes: second person (tuteo), active voice, no corporate jargon.

## Onboarding / first use

**Tone:** Warm, motivating, accompanying.
**Communicate:** That the person is already in. What they can do. That the process is simple.
**Avoid:** Overwhelming with features. Technical jargon. Generic phrases.

✅ "Hola, [Nombre]. Ya estás dentro de Humand. Desde aquí vas a poder conectarte con tu empresa, consultar tus beneficios y estar al tanto de los comunicados de tu equipo."
❌ "¡Bienvenido a la plataforma de gestión integral de experiencia del empleado más innovadora del mercado!"

## Successful flows (confirmations, achievements)

**Tone:** Celebratory, genuine, brief.
**Communicate:** That the action is done. What happens next (if applicable).
**Avoid:** Overly formal language. More than one exclamation mark. Redundancy.

✅ "Listo. Enviamos tu solicitud. Te avisamos cuando haya una respuesta."
❌ "La operación fue completada exitosamente."
✅ "Completaste tu perfil al 100 %. Tu equipo ya puede encontrarte y conectarse contigo."
❌ "¡Tu perfil está completo! ¡Felicitaciones por este logro!"

## Errors (validation, system, permissions)

**Tone:** Empathetic, direct, no alarm. Solution-oriented.
**Communicate:** What happened (without jargon). What the person can do to fix it.
**Avoid:** Blaming the person. Error codes without context. Passive phrases. Messages without a way out.

✅ "No pudimos guardar los cambios. Revisa tu conexión e inténtalo de nuevo. Si el problema sigue, escríbenos a soporte@humand.com"
❌ "Se ha producido un error inesperado (cod. 500). Por favor, inténtelo de nuevo más tarde."
✅ "Completa este campo para continuar."
❌ "El campo es requerido."

## Empty states

**Tone:** Guiding, calm, useful.
**Communicate:** Why it's empty. What the person can do (or what will happen).
**Avoid:** Generic phrases. Leaving without context.

✅ (With action) "Todavía no hay solicitudes. Cuando alguien envíe una, la vas a ver aquí."
❌ "No hay datos disponibles."
✅ (No action) "Todavía no hay comunicados publicados. Cuando el equipo de comunicación publique uno, lo vas a ver aquí."
❌ "No hay contenido disponible."
✅ (Direct action) "No tienes beneficios cargados todavía. Agrega el primero desde el botón de abajo."

## Notifications (push, in-app, email)

**Tone:** Direct, actionable, respectful of time.
**Communicate:** What happened or what the person needs to do. No filler.
**Avoid:** Ellipses. Cut-off phrases. Clickbait. Repeating info between title and body.

✅ (Push) "Tienes una nueva solicitud pendiente de aprobación."
❌ (Push) "Notificación de solicitud..."
✅ (Email) "Hola, [Nombre]. Tienes una evaluación de desempeño pendiente. Complétala antes del viernes."
❌ (Email) "Estimado colaborador, le recordamos que tiene pendiente la realización de su evaluación de desempeño."

## Tooltips and hints

**Tone:** Clear, concise, informative.
**Communicate:** The info the person needs to understand the element.
**Avoid:** Long phrases. Redundant explanations.

✅ "Fecha en que el empleado ingresó a la empresa" / "Este dato es visible solo para el área de RRHH"
❌ "En este campo deberás ingresar la fecha correspondiente al momento en que el empleado comenzó a prestar servicios en la empresa."

## Confirmation modals (destructive actions)

**Tone:** Serious, clear, no drama.
**Communicate:** What happens on confirm. If it's irreversible, say it.
**Avoid:** Diminutives. Celebratory tone. Ambiguity about the consequence.

✅ "¿Quieres eliminar este comunicado? Esta acción no se puede deshacer."
❌ "¿Estás seguro de que quieres borrar esto?"
✅ "Si das de baja a este colaborador, va a perder el acceso a la plataforma de forma inmediata."
❌ "¿Proceder con la baja?"

## Loading / waiting states

**Tone:** Calm, brief. If long, report progress.
**Communicate:** What's happening. That no action is needed.
**Avoid:** Long phrases. Forced humor. Silence if the wait exceeds 3 seconds.

✅ "Cargando tu información..." / "Estamos procesando los datos. Puede tardar unos segundos."
❌ "Por favor espere mientras el sistema procesa su solicitud."

## Offboarding / account deletion

**Tone:** Professional, empathetic, no guilt-based retention.
**Communicate:** What deletion entails. What happens with the data. Steps to complete it.
**Avoid:** Dramatic tone. Blaming. Diminutives. Superlatives about what is "lost".

✅ "Si das de baja tu cuenta, vas a perder acceso a tu historial y beneficios. ¿Quieres continuar?"
❌ "¡No te vayas! Vas a perder todas las increíbles funcionalidades que tenemos para ti."
✅ "Lamentamos que te vayas. Si necesitas ayuda con algo antes de la baja, escríbenos a soporte@humand.com"
