El blog de Changeloop
Release notes, en la práctica
Dos cosas en las que pensamos mucho: cómo escribir release notes que alguien lea y cómo dejar de mantener un changelog a mano. Sin newsletter, sin registro. Solo los textos.
Pruebas alfa vs beta: diferencias y cuándo usar cada una
Pruebas alfa y beta comparadas: quién prueba, estado de la build, betas cerradas y abiertas, criterios de salida y cómo gestionar el feedback.
Ciclo de feedback8 min de lectura
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
Modelo de Kano: prioriza según lo que sienten tus clientes
El modelo de Kano clasifica funciones en obligatorias, de rendimiento y de deleite con dos preguntas. Cómo aplicarlo a solicitudes y leerlo.
Ciclo de feedback6 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
Puntuación RICE: fórmula, ejemplo resuelto y errores
La puntuación RICE ordena ideas por alcance, impacto, confianza y esfuerzo. La fórmula, un ejemplo con cuatro funciones, las escalas y los errores comunes.
Ciclo de feedback5 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
Cómo crear una roadmap de producto con feedback de clientes
Cómo crear una roadmap de producto en seis pasos, desde las solicitudes que ya tienes. Agrupa, ordena, marca la confianza y revísala para que dure.
Ciclo de feedback6 min de lectura
Plantilla de roadmap de producto: campos para copiar
Una plantilla de roadmap de producto es una tabla con campos fijos por elemento. Copia la versión de seis campos, mírala rellena y descubre qué quitar.
Ciclo de feedback6 min de lectura
Versionado de API REST: URL, cabecera o query, cuál encaja
Versionado de API REST: la versión va en la ruta, una cabecera o la query string. Qué implica cada opción para llamantes, cachés y avisos, con ejemplos.
Cambios de API7 min de lectura
Notas de versión de software: qué son y qué incluir
Las notas de versión de software dicen qué cambió, a quién afecta y qué hacer. Los cuatro tipos, qué incluir y un ejemplo completo que puedes copiar.
Release notes en la práctica6 min de lectura
Notas de versión de corrección de errores: cómo escribirlas
Las notas de corrección de errores funcionan si cada entrada nombra el síntoma, a quién afectó y qué hacer. Incluye reescrituras y reglas de seguridad.
Release notes en la práctica8 min de lectura
Cómo pedir feedback a los clientes en tu producto
Haz una pregunta concreta justo después de que el usuario haga algo, donde trabaja. Frases listas para cada momento y los malos enfoques que evitar.
Ciclo de feedback8 min de lectura
Ejemplos de roadmap de producto: seis formatos
Seis ejemplos de roadmap de producto con entradas realistas: Now/Next/Later, trimestral, por temas, por resultados, pública y de releases, con sus fallos.
Ciclo de feedback8 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
Ejemplos de notas de versión para cada tipo de cambio
Ejemplos de notas de versión para función, corrección, cambio incompatible, seguridad, deprecación, tienda de apps y nota interna, y por qué sirven.
Release notes en la práctica8 min de lectura
Versionado de la API de Stripe: cómo funciona y qué copiar
Stripe fija cada cuenta a una versión con fecha y deja que cualquier petición la sustituya. Cómo funciona, qué cuesta y qué puede copiar una API pequeña.
Cambios de API8 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
Notas de versión de emergencia: escribir bajo presión real
Un lanzamiento impulsado por un incidente necesita notas escritas en minutos, no días, y el proceso habitual de redacción asume tiempo que no tienes.
Release notes en la práctica6 min de lectura
Breaking changes de Protobuf: qué sobrevive en el wire
Los breaking changes de Protobuf ocurren en el wire, no en la URL. Algunos cambios de campo en gRPC son gratis, otros rompen a cada cliente en silencio.
Cambios de API7 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
Solicitudes duplicadas: fusionar sin perder la voz original
Agrupar solicitudes de función duplicadas protege el recuento. Fusionarlas sin cuidado pierde la redacción que hacía útil a una, la pérdida más pequeña.
Ciclo de feedback6 min de lectura
Deprecación en GraphQL sin número de versión
GraphQL no tiene v1 ni v2 en la URL. Los campos se deprecan uno a uno con una directiva, en un esquema compartido, y eso cambia lo que exige un changelog.
Cambios de API6 min de lectura
Cómo escribir una guía de migración de API
Una guía de migración de API convierte un cambio incompatible en una checklist en vez de una caída. Qué necesita, y por qué una entrada no basta sola.
Cambios de API6 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
Cómo rechazar una solicitud sin perder a la clienta
Cerrar el círculo suele significar decir que algo se lanzó. La mitad difícil es decir que no, de una forma que no dañe la relación con la clienta.
Ciclo de feedback5 min de lectura
Notas de versión de feature flags: qué decir, y cuándo
Las notas de versión de feature flags separan fusionar y lanzar, que con un flag ya no coinciden. Cerrar el ciclo antes anuncia una función invisible.
Ciclo de feedback6 min de lectura
Seguimiento de solicitudes de funciones, sin perderlas
El seguimiento de solicitudes de funciones suele fallar de dos formas: no llegan a ningún sitio, o a uno que nadie mira. Un sistema que resiste ambas.
Ciclo de feedback7 min de lectura
Solicitud de función vs bug: cómo distinguirlos
Un ticket que pide un nuevo ajuste puede ser un workaround para un bug oculto. La etiqueta equivocada la manda a la dueña y la cola equivocadas.
Ciclo de feedback5 min de lectura
Tickets de soporte vs. solicitudes: ¿en qué confías?
Un ticket de soporte y un tablero de solicitudes miden cosas distintas, y tratar un pico en uno como equivalente al otro produce prioridades erróneas.
Ciclo de feedback5 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 de API internas: qué cambia para el otro equipo
Un changelog de API pública tiene un público al que no puedes contactar. Uno interno tiene un público a dos pisos, y eso cambia lo que debe incluir.
Cambios de API6 min de lectura
Notas de release internas: quién más debe saberlo
Soporte y ventas suelen enterarse de un lanzamiento por una clienta confundida. Las notas internas lo arreglan, con una forma distinta a las públicas.
Release notes en la práctica6 min de lectura
Notas de versión de apps: límites de App Store y Google Play
App Store admite 4.000 caracteres y Google Play 500, y ambas muestran unas pocas líneas sin enlaces. Qué recorta el límite y cómo recortar a propósito.
Release notes en la práctica5 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
Anuncio de función nueva: plantillas y cómo escribirlo
La mayoría de los anuncios de funciones mueren en un canal que nadie lee dos veces. Dónde anunciar, qué decir primero y cómo llegar a quien lo pidió.
Release notes en la práctica6 min de lectura
Cómo priorizar solicitudes de funciones que se acumulan
Un backlog deja abierta la pregunta difícil: qué solicitud sale primero. Los marcos que sirven, dónde falla cada uno, y qué esconde el recuento de votos.
Ciclo de feedback6 min de lectura
Notas de versión enterprise: qué cambia para una sola cuenta
Las notas de versión enterprise para un cliente en un build privado deben ajustarse a su instancia. Si no, filtran el roadmap o confunden a su soporte.
Release notes en la práctica5 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
El header sunset de una API, y cuándo enviarlo
El header sunset de una API dice cuándo una versión dejará de responder, a diferencia de una deprecación. Qué cubre RFC 8594 y qué aporta un brownout.
Cambios de API6 min de lectura
Changelogs de webhooks: el breaking change que nadie pidió
Un cambio en el payload de un webhook rompe en silencio, porque nadie lo rechaza. Qué hace que un cambio de payload sea rompedor y cómo versionarlo.
Cambios de API6 min de lectura
Qué es un changelog: definición y ejemplo de entrada
Un changelog es el registro fechado de lo que cambió en un producto, escrito para sus usuarios. La definición, un ejemplo de entrada y una plantilla.
Release notes en la práctica7 min de lectura
Changelog de API: qué publicar y quién lo lee
Un changelog de API lo lee gente que decide si su código seguirá funcionando el próximo mes. Qué le debe cada entrada, dónde vive, cómo se suscriben.
Cambios de API8 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
La plantilla de email de novedades que sí se lee
El email de novedades que se lee fue a alguien que lo pidió. Una plantilla, los cuatro tipos de email, líneas de asunto, segmentación y consentimiento.
Release notes en la práctica6 min de lectura
Buenas prácticas de versionado de API, para los llamantes
Versiona solo lo que rompe algo, pon la versión donde los llamantes la vean, y mantén la vieja funcionando hasta una fecha. Cuatro esquemas comparados.
Cambios de API8 min de lectura
¿Qué es un breaking change? Qué cuenta y cómo lanzarlo
Un cambio que rompe algo es el que un llamante correcto no resistiría. Qué cuenta, qué no, cómo detectarlo en CI y cómo lanzarlo con seguridad.
Cambios de API11 min de lectura
Deprecación de API: calendario, aviso y headers RFC 9745
La deprecación es una promesa con fecha. Calendario, plantilla de aviso, headers de respuesta y el paso que evita que un sunset sea un incidente.
Cambios de API7 min de lectura
Cerrar el ciclo de feedback desde el changelog
Un ciclo de feedback se cierra cuando quien preguntó sabe que se lanzó. El ciclo en cuatro pasos, dónde se rompe y por qué el changelog es el sitio.
Ciclo de feedback9 min de lectura
Plantilla de solicitud de función que se vuelve changelog
Una solicitud de función solo sirve si se encuentra al lanzarse. La plantilla, las etiquetas que la enrutan, y los campos que luego lee el changelog.
Ciclo de feedback7 min de lectura
Roadmap pública desde tu issue tracker, tres columnas
Una roadmap pública es una promesa sobre el futuro. Mantenla pequeña, aliméntala de tus issues, y mueve cada elemento con una etiqueta en su issue.
Ciclo de feedback6 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
Changelog vs. notas de versión: ¿cuál es la diferencia?
Un changelog es un registro para quien busca algo. Las notas de versión son un mensaje curado para quien decide si le importa. En qué se diferencian.
Release notes en la práctica6 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
Cómo escribir notas de versión que la gente realmente lea
«Corrección de errores y mejoras de rendimiento» no es una nota de versión. La pregunta que cada entrada debe responder, y la reescritura de una real.
Release notes en la práctica7 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
Buenas prácticas de notas de versión que valen la pena
La mayoría de listas de buenas prácticas son consejos de estilo. Estas cambian lo que hace el lector, y tres populares que son puro culto a la forma.
Release notes en la práctica6 min de lectura