¿Qué es el Versionado Semántico?

🎯 Introducción

El Versionado Semántico (o SemVer) es un sistema de numeración que nos ayuda a comunicar el tipo de cambios que hacemos en nuestro software. Es como un lenguaje universal que todos los desarrolladores entienden.

Cada versión se representa con tres números separados por puntos:

O en Español:

• El primer número (MAJOR) indica cambios que rompen la compatibilidad
• El segundo número (MINOR) indica nuevas funcionalidades compatibles
• El tercer número (PATCH) indica correcciones de errores compatibles

🖥️ ¿Cómo funciona?

MAJOR (1.x.x)

Este número cambia cuando hacemos cambios que rompen la compatibilidad con versiones anteriores. Por ejemplo:

• Eliminamos una función que otros desarrolladores podrían estar usando
• Cambiamos cómo funciona una característica existente
• Modificamos la estructura de datos que devuelve una API

MINOR (x.1.x)

Este número aumenta cuando agregamos nuevas funcionalidades que son compatibles con versiones anteriores:

• Agregamos nuevas funciones
• Incluimos nuevas características
• Añadimos nuevas opciones de configuración

PATCH (x.x.1)

Este número cambia cuando hacemos correcciones de errores que son compatibles con versiones anteriores:

• Arreglamos bugs
• Mejoramos el rendimiento
• Corregimos errores tipográficos en la documentación

📌 Ejemplos Prácticos

Veamos algunos ejemplos de cómo cambiarían los números:

// Versión 1.0.0 - Primera versión estable
function saludar(nombre) {
  return `¡Hola ${nombre}!`;
}

// Versión 1.1.0 - Nueva característica (MINOR)
function saludar(nombre, idioma = "es") {
  const saludos = {
    es: "¡Hola",
    en: "Hello",
    fr: "Bonjour",
  };
  return `${saludos[idioma]} ${nombre}!`;
}

// Versión 1.1.1 - Corrección de bug (PATCH)
function saludar(nombre, idioma = "es") {
  const saludos = {
    es: "¡Hola",
    en: "Hello",
    fr: "Bonjour",
  };
  return `${saludos[idioma] || saludos.es} ${nombre}!`; // Corregido para manejar idiomas no soportados
}

// Versión 2.0.0 - Cambio que rompe compatibilidad (MAJOR)
function saludar(nombre, opciones = {}) {
  const { idioma = "es", formal = false } = opciones;
  const saludos = {
    es: formal ? "Buenos días" : "¡Hola",
    en: formal ? "Good day" : "Hello",
    fr: formal ? "Bonjour" : "Salut",
  };
  return `${saludos[idioma] || saludos.es} ${nombre}!`;
}

🔢 Versiones Preliminares

A veces necesitamos publicar versiones que aún no están listas para producción. Para esto, usamos etiquetas especiales:

• alpha: 1.0.0-alpha.1
• beta: 1.0.0-beta.2
• rc (release candidate): 1.0.0-rc.1

Comentarios