Generador de notas de lanzamiento gratuito

¿Qué son las notas de lanzamiento?

Las notas de lanzamiento son un breve resumen de lo que ha cambiado en una nueva versión de un producto: nuevas funcionalidades, mejoras y correcciones, redactadas para que el lector sepa qué puede hacer ahora. Un generador de notas de lanzamiento convierte la lista bruta que ya tiene tu equipo, como commits o tickets, en ese resumen, para que las notas se publiquen junto con el lanzamiento en lugar de una semana después.

Unas buenas notas de lanzamiento explican a los clientes por qué una actualización es importante para ellos. Los mensajes de commit dicen a los desarrolladores qué código cambió. El trabajo consiste en traducir lo uno en lo otro.

¿Notas de lanzamiento o changelog?

La gente usa los términos de forma imprecisa. Una distinción útil:

Esta herramienta también funciona como generador de changelog: genera notas para cada lanzamiento y añádelas a la parte superior de tu página de changelog.

Qué incluir en las notas de lanzamiento

• Título con producto y versión: “Notas de lanzamiento de Acme Analytics 3.2”.
• Un resumen de una línea: el cambio o los dos cambios que más interesan a los lectores.
• Nuevas, Mejoradas, Corregidas: en ese orden, omitiendo las secciones vacías.
• Viñetas centradas en beneficios: lo que el usuario puede hacer ahora, no lo que hace el código.
• Cambios disruptivos: exactamente lo que alguien tiene que hacer, indicado claramente.
• Enlaces: al artículo de ayuda o vídeo para cualquier cosa que necesite explicación.

Un ejemplo breve de notas de lanzamiento

Tres commits, “feat: export reports to CSV”, “fix: dashboard timezone off by one hour” y “chore: bump dependencies”, podrían convertirse en:

Acme Analytics 3.2
Ahora puedes llevarte tus informes a cualquier parte y los paneles muestran las horas correctas.

Nuevas

• Exportación CSV: descarga cualquier informe como archivo CSV para abrirlo en Excel o Google Sheets.

Corregidas

• Horas del panel: los gráficos ahora utilizan tu zona horaria correctamente.

La actualización de dependencias se omite en la versión para clientes, porque los usuarios no la notarán. La versión interna sí la mantiene.

Cómo preparar tus cambios para el generador

No necesitas limpiar tu lista primero, pero algunos hábitos dan mejores notas. Pega un cambio por línea, ya sea un mensaje de commit, un título de ticket o una frase. Mantén prefijos convencionales como “feat:” y “fix:” si los usas; ayudan a clasificar los cambios en nuevos y corregidos. Añade una palabra de contexto a los elementos crípticos, por ejemplo “fix: export (CSV was empty for large reports)”. Rellena el nombre del producto y la versión para que el título esté listo para publicar. Luego ejecútalo dos veces si necesitas ambas versiones: una para clientes, otra para el equipo interno.

Mejores prácticas para las notas de lanzamiento

Escribe para la persona que usa el producto

“Los informes cargan más rápido” es mejor que “Planificador de consultas optimizado”. Nombra la funcionalidad tal como aparece en la interfaz.

Empieza por lo más importante

Pon primero el cambio que la mayoría de la gente notará. Las pequeñas correcciones pueden ir en una línea cada una al final.

Muestra la nueva funcionalidad

Una captura de pantalla o un vídeo corto de una nueva funcionalidad hace más que un párrafo. Enlaza el artículo de ayuda que la explica.

Publica en un horario que la gente pueda encontrar

Mantén cada lanzamiento en una página de changelog, con el más reciente primero, para que los clientes y tu equipo de soporte siempre sepan dónde buscar.

Errores comunes en las notas de lanzamiento

• Pegar el registro de commits tal cual, con números de ticket y jerga.
• Ocultar un cambio disruptivo en medio de una lista.
• Listar cada cambio interno en las notas para clientes.
• Prometer fechas o funcionalidades que no están en el lanzamiento.

El generador solo incluye cambios de tu lista y no añadirá fechas que no le hayas dado, pero revisa cada elemento antes de publicar.