Versionado de proyectos de software

**Versionado de Proyectos de Software**
=====================================

**Introducción**
---------------

El versionado es una práctica fundamental en el desarrollo de software que permite gestionar cambios, mantener la trazabilidad del código y facilitar la colaboración entre equipos. Una estrategia de versionado clara reduce errores en despliegues, mejora la comunicación entre desarrolladores y ayuda a los usuarios a entender el impacto de cada actualización. En este artículo, exploraremos las mejores prácticas para implementar un sistema de versionado efectivo en tus proyectos de software.

**El Significado de la Convención SemVer**
---------------------------------------

La convención más utilizada en la industria es la de Semantic Versioning (SemVer), que utiliza el formato `MAJOR.MINOR.PATCH` para identificar cada versión. Este formato es claro y fácil de entender, y permite que cualquier desarrollador entienda rápidamente el alcance de una actualización sin necesidad de revisar todo el código.

### 🔢 ¿Qué significa cada número?

- **MAJOR** → Cambios incompatibles con versiones anteriores (*breaking changes*).
- **MINOR** → Nuevas funcionalidades compatibles con versiones previas.
- **PATCH** → Correcciones de errores o mejoras internas sin impacto en la API.

**Decidir la Nueva Versión**
---------------------------


- ¿Rompiste compatibilidad con versiones anteriores? → **Incrementa `MAJOR`**
- ¿Añadiste nuevas funcionalidades compatibles? → **Incrementa `MINOR`**
- ¿Solo corregiste errores o hiciste mejoras menores? → **Incrementa `PATCH`**

### > 🧠 **Ejemplo:**
> Si la versión actual es `v1.2.3` y corriges un bug, la nueva versión debería ser `v1.2.4`.

**Crear una Release con Git**
---------------------------

Una vez decidida la versión, es recomendable etiquetar el commit correspondiente usando **Git Tags**. Las etiquetas permiten marcar puntos importantes en la historia del repositorio, normalmente asociados a releases.

### Crear una etiqueta anotada (recomendado)

Las etiquetas anotadas almacenan metadatos como autor, fecha y mensaje.

```bash
git tag -a v1.0.0 -m "Release: versión inicial"
git push origin v1.0.0
```

Usar el prefijo v (v1.0.0) es una convención ampliamente adoptada que facilita la identificación de versiones.

### 🔎 Consultar versiones existentes


```bash
git tag
```


```bash
git show v1.0.0
```


```bash
git describe --tags --abbrev=0
```

Esto es especialmente útil en pipelines de CI/CD o scripts de automatización.

**Buenas Prácticas de Versionado**
---------------------------------

### ✅ Mantén un CHANGELOG

Documenta qué cambió en cada versión. Facilita auditorías, debugging y comunicación entre equipos.


## v1.3.0
- Nueva autenticación OAuth2
- Mejora del rendimiento en consultas

## v1.2.1
- Corrección de vulnerabilidad XSS

### ✅ Automatiza el versionado cuando sea posible


* semantic-release → Genera versiones automáticamente a partir de commits.
* standard-version → Alternativa más simple sin necesidad de CI complejo.
* GitHub Releases / GitLab Releases → Permiten publicar artefactos y notas de versión.

La automatización reduce errores humanos y hace el proceso reproducible.

### ✅ Usa Conventional Commits

Estandarizar los mensajes de commit facilita la generación automática de changelogs y versiones.

**Conclusión**
--------------

Implementar un sistema de versionado efectivo en tus proyectos de software es fundamental para garantizar la calidad y la estabilidad del código. Al seguir las mejores prácticas descritas en este artículo, podrás reducir errores en despliegues, mejorar la comunicación entre desarrolladores y ayudar a los usuarios a entender el impacto de cada actualización. Recuerda que la clave para un sistema de versionado exitoso es mantener un CHANGELOG, automatizar el versionado cuando sea posible y usar Conventional Commits.