Ingeniería
Changelogs como artefacto de build: convenciones, automatización, pipelines.
Empieza por aquí: Keep a Changelog explicado, con plantilla de CHANGELOG.md, De conventional commits a un changelog, Automatización de changelog: qué automatizar y qué no
-
Qué es un hotfix: significado, diferencias y cómo lanzarlo
Un hotfix es una corrección urgente fuera del ciclo normal de lanzamientos. Qué significa, en qué se diferencia de un parche y cómo lanzarlo con seguridad.
Ingeniería7 min de lectura
-
Release candidate (RC): qué significa y cómo gestionarlo
Una release candidate es una build que sale como versión final salvo que las pruebas encuentren un bloqueo. Dónde encaja tras la beta, versionado y salida.
Ingeniería5 min de lectura
-
CHANGELOG.md: qué incluir y cómo mantenerlo al día
Un CHANGELOG.md registra para el lector lo que cambió en cada versión. Qué secciones necesita, un ejemplo completo y el hábito que lo mantiene al día.
Ingeniería6 min de lectura
-
Notas de release de GitHub: genéralas y hazlas legibles
GitHub redacta notas de release desde los pull requests con un clic. Qué contiene el borrador, cómo lo moldea release.yml y la edición que lo hace legible.
Ingeniería7 min de lectura
-
Proceso de gestión de releases para publicar a menudo
Un proceso de gestión de releases en siete pasos, con responsable y criterios de salida para cada uno, más las métricas DORA y un indicador más que seguir.
Ingeniería8 min de lectura
-
Quién escribe el changelog, y quién debería
¿Quién escribe el changelog? Quien abre el PR sabe qué cambió; la PM, por qué importa. Ninguna sola escribe una entrada útil, y elegir una lo deja viejo.
Ingeniería6 min de lectura
-
Formatos de archivo de changelog: JSON, YAML o solo Markdown
El formato de un archivo de changelog decide si puede alimentar una página y un widget, o solo lo lee alguien. Markdown, JSON y YAML cuestan distinto.
Ingeniería6 min de lectura
-
Exigir una entrada de changelog en GitHub Actions
Un check de changelog en GitHub Actions rechaza el merge sin entrada, porque un paso que depende de la memoria falla siempre. Y qué rompe ese check.
Ingeniería6 min de lectura
-
Tags de git vs lanzamientos de GitHub vs changelog
Un tag de git, un lanzamiento y una entrada de changelog son tres registros de un evento. Confundirlos desvía el changelog. Cómo deben encajar.
Ingeniería6 min de lectura
-
Changelogs en monorepo: ¿uno solo, o uno por paquete?
Un monorepo puede llevar un changelog para todo el repo o uno por paquete, y elegir mal hace cada lanzamiento demasiado ruidoso o demasiado disperso.
Ingeniería6 min de lectura
-
Semantic versioning y tu changelog: qué significa cada salto
Semantic versioning le dice a quien llama cuánto puede dolerle un lanzamiento antes de leer el changelog. Qué promete cada número y qué debe una entrada.
Ingeniería6 min de lectura
-
Página de changelog pública: cómo hacer una que se siga
Una página de changelog vale la pena cuando alguien vuelve a ella. Dónde vive, qué necesita cada entrada, feeds y marcado, y cómo encaja el widget.
Ingeniería7 min de lectura
-
Automatización de changelog: qué automatizar y qué no
Automatiza recolección, formato y publicación. No automatices selección ni redacción. Dónde está la línea y qué pasa cada vez que se mueve, en detalle.
Ingeniería7 min de lectura
-
De conventional commits a un changelog
Los conventional commits hacen un changelog derivable. No lo hacen legible. Lo que aporta la convención, dónde se detiene, y cómo cerrar la brecha.
Ingeniería6 min de lectura
-
Keep a Changelog explicado, con plantilla de CHANGELOG.md
La especificación es una página y se lee en diez minutos. Implementarla es donde los equipos se desvían. Qué dice, qué deja abierto, y dónde falla.
Ingeniería6 min de lectura