Saltar al contenido

Cómo escribir notas de versión que tus clientes lean (con ejemplos de changelog)

La mayoría de changelogs de SaaS los escriben desarrolladores para desarrolladores, y nadie los lee. Cómo escribir notas de versión que expliquen qué cambia para el cliente, qué incluir y qué no, ejemplos buenos y malos, por qué canales avisar y cómo usarlas para cerrar las peticiones y los bugs que reportaron tus clientes.

Adrià Castany 10 min

En esta página
  1. ¿Cómo se escriben unas buenas notas de versión?
  2. Qué cambia para el cliente
  3. Qué incluir
  4. Ejemplo de una entrada
  5. Dónde publicarlas
  6. Avisar a quien lo pidió
  7. Notas de versión y soporte
  8. Errores frecuentes
  9. Preguntas frecuentes
  10. Para seguir
Cohete de juguete despegando sobre fondo azul
Así contesta el agente de IA de Intake con la documentación de cada empresa

«v2.14.3: fix en el parser de webhooks, refactor del módulo de facturación, bump de dependencias.» Así son muchas notas de versión de SaaS. Las escribe quien hizo el cambio para quien hizo el cambio, y el cliente que las lee no saca nada en claro: ¿ya funciona lo que le fallaba? ¿Hay algo nuevo que le sirva?

Las notas de versión son de lo poco que un SaaS cuenta a todos sus clientes con regularidad. Bien escritas, enseñan que el producto avanza, ahorran preguntas y sirven para avisar a quien pidió algo o reportó un fallo. Mal escritas, nadie las lee.

¿Cómo se escriben unas buenas notas de versión?

Explicando qué cambia para el cliente. Cada entrada dice qué puede hacer ahora o qué problema ya no tendrá, en una o dos frases, con una captura o un enlace si ayuda. Se agrupan en novedades, mejoras y correcciones, llevan fecha y se publican en un changelog fácil de encontrar. Lo importante se avisa también dentro del producto o por correo, y a los clientes que pidieron algo o reportaron un fallo se les escribe personalmente.

Qué cambia para el cliente

Cada entrada tiene que responder a «¿y a mí qué?».

MalBien
Refactor del módulo de exportaciónLas exportaciones grandes ahora tardan segundos en vez de minutos
Fix en el parser de webhooksLos webhooks con caracteres especiales ya no fallan
Nuevo endpoint /invoices/bulkAhora puedes crear varias facturas a la vez desde la API
Mejoras de rendimientoEl panel principal carga el doble de rápido con muchos proyectos

Si un cambio no cambia nada para el cliente, como una dependencia actualizada o una limpieza interna, no va en las notas de versión.

Qué incluir

  • Novedades: funciones nuevas, con una captura o un vídeo corto si se ven en pantalla.
  • Mejoras: cosas que ya existían y ahora funcionan mejor.
  • Correcciones: fallos que los clientes podían notar.
  • Cambios que piden algo al cliente: algo que deja de funcionar o una configuración que hay que revisar. Estos van arriba y destacados.

Cada entrada lleva:

  1. Un título que diga el beneficio.
  2. Una o dos frases con lo necesario para entenderlo.
  3. Dónde encontrarlo, o un enlace a la ayuda.
  4. Para quién es, si no es para todos: «disponible en el plan Pro».

Ejemplo de una entrada

Duplica un proyecto con todas sus tareas
Ahora puedes copiar un proyecto entero, con sus tareas, responsables y plantillas, desde el menú del proyecto → Duplicar. Útil si repites el mismo trabajo para cada cliente. Disponible en todos los planes.

Y una corrección:

Las facturas con descuento del 100 % ya se guardan bien
Antes, aplicar un descuento del 100 % daba un error al guardar. Ya está corregido; si usabas el 99,99 % para salir del paso, ya no hace falta.

Intake con los casos reales de la empresa, en una demo de 15 minutos

Dónde publicarlas

  • En una página de changelog pública, con fecha y lo último arriba. Sirve también a quien está evaluando el producto, como prueba de que avanza.
  • Dentro del producto, para lo importante: un aviso discreto o un punto en el menú.
  • Por correo, con un resumen mensual o trimestral, nunca un correo por cada cambio.

Cuánto hay que comunicar cada cambio:

CambioChangelogEn el productoCorreo
Corrección menorSíNoNo
Mejora notableSíA vecesEn el resumen
Novedad importanteSíSíSí
Cambio que exige acciónSíSíSí, con antelación

Avisar a quien lo pidió

Las notas de versión son el momento de cerrar dos cosas que casi siempre quedan pendientes:

Para hacerlo, las peticiones y los fallos tienen que estar registrados con los clientes que los pidieron. Con eso, avisar lleva minutos.

Notas de versión y soporte

Una nota de versión clara ahorra preguntas: el «¿por qué ha cambiado este botón?» queda respondido antes de que nadie lo pregunte. Pero soporte tiene que conocer los cambios antes de que salgan, y no enterarse por los clientes. Si atiende un agente de IA, la documentación que consulta tiene que estar al día el mismo día: un agente que explica cómo se hacía algo antes del cambio confunde más que ayuda.

En Intake, un flujo puede enseñar un aviso en el chat cuando el cliente visita una página concreta, de modo que la novedad se anuncia en la pantalla a la que afecta y no en todas. Más en mensajes.

Errores frecuentes

  • Escribir para el equipo técnico en vez de para el cliente.
  • Mezclar lo interno con lo que ve el cliente.
  • No avisar de los cambios que rompen algo hasta que lo rompen.
  • Mandar un correo por cada cambio, que acaba ignorado o en spam.
  • No actualizar la documentación a la vez.

Preguntas frecuentes

¿Qué son las notas de versión?

El registro de lo que cambia en cada versión de un producto, escrito para sus usuarios: novedades, mejoras y correcciones.

¿Qué diferencia hay entre changelog y notas de versión?

En la práctica se usan como sinónimos. A veces el changelog es el registro completo y técnico, y las notas de versión son la versión para clientes.

¿Cada cuánto hay que publicarlas?

Cada vez que algo cambia para el cliente, con un resumen por correo cada mes o cada trimestre.

¿Hay que incluir las correcciones de fallos?

Las que los clientes podían notar, sí. Son de las entradas que más se agradecen.

¿Cómo aviso de un cambio que obliga al cliente a hacer algo?

Con antelación, destacado en el changelog, dentro del producto y por correo, explicando qué tiene que hacer y hasta cuándo.

Para seguir

Siguiente pasoPlantillas para comunicar cambios a clientesLa nota de versión, el aviso de un cambio que rompe algo y el correo de subida de precio.

Las novedades, por correo

RSS

Solo las novedades, con la baja en cada correo. Más detalle en la política de privacidad.

De perseguir conversaciones a cuidar a cada cliente

15 minutos, sin compromiso