Saltar al contenido

Notas de versión (changelog)

Adrià Castany 2 min

¿Qué son las notas de versión?

Las notas de versión o changelog son el registro público y fechado de lo que cambia en un producto. Cada entrada cuenta qué hay de nuevo, qué se ha mejorado y qué se ha corregido, en palabras del cliente. Sirven para que el cliente sepa qué ha cambiado sin tener que preguntarlo.

También se llama

changelog, release notes, registro de cambios, novedades del producto

Tema
Conceptos de soporte
En esta página
  1. Changelog y notas de versión
  2. Por qué importa
  3. Qué lleva una entrada
  4. Tipos de cambio
  5. Lo que no va en unas notas de versión
  6. Dónde se publican
  7. Cómo lo resuelve Intake
  8. Preguntas frecuentes

Changelog y notas de versión

En equipos técnicos el changelog es la lista completa de cambios de cada versión, pensada para desarrolladores, y las notas de versión son el resumen para el usuario.

En productos para empresas los dos nombres se usan para lo mismo, la página de novedades.

Por qué importa

Cada cambio que el cliente descubre solo es una consulta a soporte o una sorpresa desagradable.

Las notas de versión reducen las dos cosas, y además enseñan a quien paga que el producto avanza. Un cliente que no ve novedades durante meses empieza a preguntarse por qué sigue pagando.

Qué lleva una entrada

Una entrada de las notas de versión lleva cinco cosas, y la segunda es la que la hace útil.

  • La fecha y, si aplica, el número de versión.
  • Qué puede hacer ahora el cliente que antes no podía.
  • A quién afecta, por plan o por función.
  • Qué tiene que hacer el cliente, si tiene que hacer algo.
  • Una imagen o un enlace a la documentación.

Tipos de cambio

Lo habitual es agrupar los cambios en cuatro tipos.

  • Novedades. Funciones que no existían.
  • Mejoras. Cambios en algo que ya existía.
  • Correcciones. Errores resueltos.
  • Cambios que requieren acción. Lo que deja de funcionar igual y obliga al cliente a hacer algo.

Lo que no va en unas notas de versión

No van los cambios internos que el cliente no nota, ni una subida de precio o un cambio de condiciones.

Esos se comunican aparte, con antelación y de forma directa a quien afectan.

Dónde se publican

Las notas se publican en una página propia y se llevan a donde el cliente ya está.

Dentro del producto, en un correo periódico y, para soporte, como aviso interno antes de que el cambio llegue a los clientes.

Cómo lo resuelve Intake

Preguntas frecuentes

¿Qué es un changelog?

El registro de cambios de un producto, ordenado por fecha. En productos para empresas es la página de novedades donde se cuenta qué se ha añadido, mejorado y corregido.

¿Cada cuánto se publican las notas de versión?

Con el ritmo al que cambia el producto. Lo importante es la regularidad. Una página que se actualiza cada dos semanas transmite más que una con muchas entradas y la última de hace seis meses.

¿Quién escribe las notas de versión?

Producto conoce el cambio y soporte conoce las palabras del cliente. Lo que funciona es que producto redacte y soporte revise antes de publicar, porque es quien recibirá las preguntas.

¿Hay que avisar de todos los cambios?

De todos los que el cliente puede notar. Los que le obligan a hacer algo se avisan además por correo y con antelación, no solo en la página de novedades.

Glosario

Sigue leyendo

Glosario

Términos relacionados

Ver el glosario completo

Intake, sin dejar las herramientas de siempre

15 minutos, sin compromiso