Generación de changelogs y notas de versión
Aprenda a generar changelogs claros y notas de versión automatizadas a partir de su historial de Git y de conventional commits.
Generación de changelogs y notas de versión es una lección gratuita de Git & GitHub Professional Workflow en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Git & GitHub Professional Workflow, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Git & GitHub Professional Workflow incluye 4 lecciones en total.
¿Qué es un changelog?
Un changelog es una lista seleccionada y legible para las personas con los cambios importantes de cada versión. Se encuentra en un archivo como CHANGELOG.md, en la raíz del repositorio.
Por qué son importantes los changelogs
Los usuarios y compañeros de equipo consultan los changelogs para comprender:
- Las nuevas funcionalidades
- Las correcciones de errores
- Los cambios incompatibles
Hacen que las actualizaciones sean más seguras y rápidas.
Formato Keep a Changelog
Una convención habitual agrupa las entradas bajo los encabezados: Añadido, Cambiado, Corregido, Eliminado.
## [1.2.0] - 2024-05-01
### Added
- Search filters
### Fixed
- Login redirect bugCommits convencionales
Los commits convencionales utilizan prefijos como feat:, fix: y BREAKING CHANGE: para que las herramientas puedan generar changelogs automáticamente.
feat: add CSV export
fix: handle empty cart
feat!: drop Node 14 supportEnumerar commits desde una etiqueta
Puede previsualizar los cambios realizados desde la última versión utilizando git log con un intervalo de etiquetas.
git log v1.1.0..HEAD --onelineRegistro con formato para las notas
Dé formato al registro como una lista de líneas con viñetas, adecuada para pegarla en las notas de la versión.
git log v1.1.0..HEAD --pretty=format:'- %s'Herramientas automatizadas para changelogs
Herramientas como standard-version o conventional-changelog leen los commits convencionales y generan el changelog junto con un incremento de versión.
npx standard-versionNotas generadas automáticamente por GitHub
GitHub puede generar automáticamente notas de la versión a partir de los pull requests fusionados al crear una versión.
gh release create v1.2.0 --generate-notesCategorizar con etiquetas
Un archivo .github/release.yml asigna las etiquetas de los PR a secciones del changelog, de modo que las notas agrupan automáticamente las correcciones de errores y las funcionalidades.
changelog:
categories:
- title: Features
labels: [feature]Revisar antes de publicar
Lea siempre las notas generadas antes de publicarlas. La automatización prepara un borrador, pero una persona debe editar la redacción y destacar los cambios incompatibles.
Vincular a las versiones
Mantenga cada entrada del changelog vinculada a su etiqueta de Git y a la página de la versión para que los lectores puedan saltar a la diferencia exacta.
[1.2.0]: https://github.com/you/repo/compare/v1.1.0...v1.2.0Comprobación rápida
Compruebe su comprensión de los changelogs y las notas de la versión.
Recapitulación
Ha aprendido a generar changelogs:
- Utilice el formato Keep a Changelog
- Los commits convencionales impulsan la automatización
git log v1..HEADpermite previsualizar los cambiosgh release create --generate-notesprepara notas a partir de los PR
Preguntas frecuentes
¿La lección «Generación de changelogs y notas de versión» es gratis?
Sí — el texto completo de «Generación de changelogs y notas de versión» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Git & GitHub Professional Workflow, actualiza a CoddyKit PRO. El curso de Git & GitHub Professional Workflow incluye 4 lecciones en total.
¿Qué aprenderé en «Generación de changelogs y notas de versión»?
Aprenda a generar changelogs claros y notas de versión automatizadas a partir de su historial de Git y de conventional commits. Practicas Git & GitHub Professional Workflow con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Git & GitHub Professional Workflow?
No se requiere experiencia previa. Git & GitHub Professional Workflow en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.
¿Cuánto tiempo toma la lección «Generación de changelogs y notas de versión»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Git & GitHub Professional Workflow?
Sí. Cada lección de Git & GitHub Professional Workflow incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Versionado semántico con tags
- Creación y gestión de releases
- Ramas de release y hotfixes
- Generación de changelogs y notas de versión