Una nueva versión no es solo «lo último que tenemos». Es un conjunto identificable de cambios que podemos explicar, comprobar, comparar y, cuando sea posible, revertir.
Una página web cambia sus contenidos, una aplicación corrige errores, una fábrica modifica materiales y un servicio ajusta su procedimiento. Si no sabemos qué versión se utilizó, por qué cambió o qué se observó después, terminamos atribuyendo resultados a recuerdos imprecisos. Versionar permite conservar una línea base y un historial de decisiones; no exige adoptar Git para todos los servicios. El versionado semántico ofrece reglas útiles para software con API pública definida [R01], mientras que las guías de entregas de GitHub explican cómo asociar versiones de código con notas y artefactos [R02]. Ninguno de esos mecanismos sustituye la gestión de cambios de una operación física o humana.
1. Diferencia versión, revisión, iteración, release y despliegue
| Concepto | Qué identifica | Ejemplo |
|---|---|---|
| Versión | Estado delimitado y reconocible de la solución | Agenda V1.2 con nuevas reglas |
| Revisión | Cambio o evaluación dentro del historial | Revisión del texto de confirmación |
| Iteración | Ciclo de aprendizaje y ajuste | Probar flujo, observar, corregir y probar |
| Release o entrega | Versión puesta a disposición de destinatarios definidos | V1.2 entregada a tres locales |
| Despliegue | Instalación o activación técnica de una versión | Publicar archivos en el servidor |
| Actualización | Cambio aplicado a un sistema o proceso existente | Sustituir guía de recepción |
Los términos pueden variar por organización. Lo importante es registrar qué estuvo realmente disponible y para quién. Hacer merge en GitHub no garantiza que el servidor haya recibido la versión; un despliegue exitoso tampoco demuestra que los usuarios pudieran completar las tareas. Una revisión editorial no es necesariamente una nueva versión pública.
2. Define qué significa «versión» según el tipo de solución
En software, una versión puede identificarse por etiqueta de código, paquete, configuración y esquema de datos. En una web, incluye plantillas, contenido, rutas y assets. En producto físico puede incluir diseño, lista de materiales, instrucciones de fabricación y lote; cambiar una pieza sin cambiar el código no es irrelevante. En servicios, puede ser la revisión controlada del procedimiento, capacitación, horario y sistema de atención.
En soluciones híbridas hay varias versiones coexistentes: app V2, equipo físico revisión B y procedimiento de soporte edición 3. Registra compatibilidades y dependencias. Una actualización de la interfaz puede requerir capacitación o modificar un contrato de atención.
3. Crea una línea base que puedas reconstruir
Una línea base es la referencia contra la cual se evalúan los cambios. Conserva identificador, fecha, alcance, requisitos, archivos o documentos relevantes, recursos, configuración, responsables y evidencias de prueba. El nivel de detalle depende del riesgo.
En un servicio pequeño, puede ser un procedimiento fechado con lista de responsables y condiciones de entrega. En software, incluye repositorio y commit, artefactos de release, configuración y migraciones necesarias. No guardes contraseñas o datos personales dentro de notas de versión. Conserva referencias a entornos seguros.
Si no puedes reconstruir la condición anterior, evita prometer un rollback sencillo. Las modificaciones de datos, materiales y procesos pueden dejar consecuencias que no desaparecen reponiendo archivos.
4. Clasifica cambios y enlázalos con una razón
Diferencia cambios correctivos (reparar defecto), adaptativos (ajustarse a otro entorno), evolutivos (añadir capacidad) y experimentales (probar hipótesis bajo condiciones). Una sola entrega puede combinar categorías, pero conviene señalar qué objetivo tiene cada modificación.
Cada cambio debería responder: ¿qué observación o requisito lo origina?, ¿qué versión se modifica?, ¿qué componente afecta?, ¿cuál es el comportamiento esperado?, ¿qué prueba lo comprobará?, ¿qué riesgo introduce?, ¿quién aprobó el cambio? Así se construye la cadena hipótesis → decisión → cambio → versión → prueba → resultado → siguiente decisión.
No todos los cambios son experimentos. Un error de ortografía corregido puede ser mantenimiento; un ajuste SEO observado con medición puede constituir una prueba exploratoria, pero no necesariamente un experimento causal controlado.
Cuando el cambio nace de una incidencia o una solicitud, relaciona la versión con el registro priorizado de hallazgos y decisiones. Así se conserva por qué se hizo el cambio y qué quedó deliberadamente fuera.
5. Utiliza numeración adecuada, sin forzar SemVer a todo
Para software que expone una API pública, el estándar Semantic Versioning 2.0.0 utiliza MAJOR.MINOR.PATCH: MAYOR para cambios incompatibles de API, MENOR para funcionalidades compatibles y PARCHE para correcciones compatibles [R01]. No significa «gran cambio visual / cambio medio / corrección pequeña» en cualquier sitio web. Si no hay contrato de compatibilidad definido, la numeración no comunica por sí sola qué se rompió.
Una empresa pequeña puede utilizar v1, v2 y una fecha, siempre que sean únicas y estén documentadas. Un lote físico puede usar modelo A / revisión C / lote 004; un procedimiento de servicio, SOP-reservas-v3. Evita identificadores ambiguos como final-definitivo-2.
6. Diseña estrategias de entrega y límites de exposición
Una versión puede entregarse a un grupo reducido, una zona, una línea de producción o todo el mercado. El despliegue gradual permite observar fallos antes de aumentar exposición, pero exige preparación y capacidad de detener el cambio. La guía británica de beta describe acceso privado inicial seguido de ampliación cuando existen evidencias y soporte [R03]; ese proceso ilustra un principio, no una obligación universal.
Define: destinatarios, condiciones de elegibilidad, fecha de activación efectiva, versión anterior, capacitación, comunicación, monitoreo, soporte, condición de parada y responsable de respuesta. Si el cambio afecta contratos, datos o seguridad, investiga las obligaciones aplicables antes de activarlo.
No llames «publicado» a algo que solo existe en un branch, ni «validado» a algo que únicamente pasó el build. Distingue preparado, integrado, desplegado, accesible y verificado en uso.
7. Gestiona compatibilidad, migraciones y retroceso
Para software, registra compatibilidad con clientes anteriores, datos, dependencias y APIs. Una migración de base de datos puede necesitar copia verificada, posibilidad de restauración y una estrategia para los registros escritos después del cambio. Un rollback de código no garantiza restaurar datos a su estado anterior.
En productos físicos, quizás sea necesario distinguir unidades de distintos lotes o retirar componentes: el retroceso puede requerir logística y comunicación. En servicios, recuperar un procedimiento anterior exige que los empleados conozcan la versión vigente y que no queden instrucciones contradictorias.
Antes de entregar, pregunta: ¿se puede revertir?, ¿qué no se puede deshacer?, ¿qué condiciones disparan la detención?, ¿quién ejecutará la respuesta? Si una reversión es imposible o peligrosa, diseña primero mitigaciones y un plan de corrección.
Antes de ampliar la entrega o intentar una reversión, revisa las pruebas de la solución y su regresión. Un cambio de versión puede corregir el caso visible y romper un comportamiento relacionado.
8. Compara versiones sin atribuir causas automáticamente
Si después de una versión mejora la retención, bajan las quejas o sube la visibilidad SEO, el cambio temporal no prueba causalidad. Pueden influir estacionalidad, otros canales, nuevos usuarios, competencia o variaciones de medición. Conserva hipótesis iniciales y registra modificaciones simultáneas.
Cuando sea posible, compara períodos y grupos equivalentes, utiliza controles o pruebas apropiadas y evita cambiar demasiadas variables a la vez. Si no se puede identificar causalidad, comunica el resultado como asociación observada con limitaciones, no como éxito demostrado de una única modificación.
Para decidir qué hipótesis revisar tras cada entrega, utiliza el Design–Test Loop, que distingue iterar con evidencia de repetir cambios hasta obtener una métrica favorable. Un historial ordenado no equivale por sí solo a una inferencia causal.
9. Documenta y comunica la entrega
Una nota de release útil debe explicar: versión y fecha real, destinatarios, cambios visibles, cambios internos relevantes, incompatibilidades, riesgos conocidos, acciones de usuarios, pruebas ejecutadas y contacto de soporte. Las notas no tienen que mencionar cada commit técnico, pero sí cambios que afecten a quienes utilizan la solución. GitHub permite agrupar versiones mediante releases y etiquetas con notas y artefactos [R02].
Mantén un registro de decisiones para saber por qué cambió la solución, un registro de pruebas para saber qué se comprobó y un historial de versiones para saber qué se entregó. Son documentos relacionados, no intercambiables.
Ejemplo trabajado: tres versiones de una web y su servicio SEO
Una empresa ficticia entrega una web y después presta un servicio mensual de contenido y SEO. Registra:
| Versión | Hipótesis o razón | Cambio controlado | Evidencia disponible | Decisión provisional |
|---|---|---|---|---|
| Web V1 | Establecer presencia y medición inicial | Estructura y contenidos base | Referencia de consultas y eventos | Mantener línea base |
| Web V2 | Mejorar correspondencia con búsquedas específicas | Reorganizar contenido de páginas seleccionadas | Cambios en consultas y clics durante un período definido | Investigar antes de atribuir causalidad |
| Web V3 | Facilitar descubrimiento de artículos relacionados | Añadir enlaces contextuales documentados | Comportamiento de navegación y visibilidad, con factores externos | Mantener o ajustar según evidencia |
Todos los resultados son hipotéticos. El equipo registra URL, versión, fecha de puesta en línea, modificaciones, referencia previa, otras campañas activas y limitaciones de comparación. Un aumento posterior de posiciones no demuestra por sí mismo que el enlazado causó el resultado.
La web es el producto digital; el SEO es un servicio recurrente que modifica versiones del producto. Confundirlos puede llevar a prometer resultados que el servicio no controla. Lo mismo ocurre con una receta que evoluciona por lotes o con una aplicación que recibe actualizaciones.
Errores habituales y límites
Tratar commit, merge y publicación como equivalentes; perder la versión de configuración; cambiar sin conservar una línea base; utilizar SemVer sin API definida; prometer retroceso sin considerar datos y consecuencias; publicar pruebas sin soporte; comparar resultados incompatibles; ocultar cambios contractuales; borrar historial desfavorable; declarar causalidad por una mejora temporal.
El versionado no es burocracia por sí mismo: su valor es que otra persona pueda reconstruir qué se cambió, qué estuvo disponible, qué se comprobó y por qué se tomó la siguiente decisión.
Qué deberías tener al terminar
Un registro de versiones y cambios con identificador, alcance, fecha real, responsables, requisitos y hallazgos vinculados, pruebas, evidencia de entrega, destinatarios, compatibilidades, riesgos, decisiones y mecanismo de corrección. No requiere un sistema complicado, pero sí continuidad y honestidad sobre lo que se conoce.
Referencias
- [R01] Tom Preston-Werner. Semantic Versioning 2.0.0. https://semver.org/
- [R02] GitHub Docs. Managing releases in a repository. https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository
- [R03] UK Government Digital Service. How the beta phase works. https://www.gov.uk/service-manual/agile-delivery/how-the-beta-phase-works