Uso de etiquetas (tags) y versionado semántico en GitHub

Vista previa del material en texto

Uso de etiquetas (tags) y versionado semántico en GitHub 
 
El uso de etiquetas (tags) y el versionado semántico en GitHub es una práctica común para mantener 
un seguimiento organizado de las versiones de tu proyecto y comunicar cambios significativos a los 
usuarios. Aquí te explico cómo utilizar etiquetas y el versionado semántico en GitHub: 
 
**Etiquetas (Tags):** 
 
Las etiquetas son puntos de referencia específicos en la historia del repositorio. Se utilizan para 
marcar versiones importantes, lanzamientos y hitos en el desarrollo del proyecto. 
 
1. **Crear una etiqueta:** 
 - En la página de tu repositorio en GitHub, ve a la pestaña "Releases" (Lanzamientos). 
 - Haz clic en el botón "Draft a new release" (Crear un nuevo lanzamiento). 
 - Llena los detalles del lanzamiento, como el título, la descripción y las notas de la versión. 
 - En el campo "Tag version" (Versión de etiqueta), ingresa un número de versión, como "v1.0.0". 
 - Publica el lanzamiento. 
 
2. **Asociar a un commit existente:** 
 - Si deseas asociar una etiqueta a un commit específico, puedes hacerlo utilizando la interfaz de 
GitHub o mediante la línea de comandos de Git con el comando `git tag`. 
 
3. **Visualización de etiquetas:** 
 - Las etiquetas y los lanzamientos se mostrarán en la página "Releases" del repositorio, lo que 
permite a los usuarios ver las versiones disponibles y sus detalles. 
 
**Versionado Semántico:** 
 
El versionado semántico es una convención para asignar números de versión significativos a tu 
software. Sigue un patrón de tres números: `X.Y.Z`. 
 
1. **Versión Mayor (X):** 
 - Incrementa cuando realizas cambios incompatibles con versiones anteriores, como cambios 
estructurales o de API que podrían romper la compatibilidad. 
 
2. **Versión Menor (Y):** 
 - Incrementa cuando agregas nuevas funcionalidades de manera compatible con versiones 
anteriores. 
 
3. **Versión de Parche (Z):** 
 - Incrementa cuando realizas correcciones de errores u otras mejoras que no afectan la 
compatibilidad. 
 
Siguiendo esta convención, los usuarios pueden comprender rápidamente el alcance y el impacto de 
una versión en función de los números de versión. 
 
**Uso en GitHub Actions:** 
 
Puedes aprovechar GitHub Actions para automatizar la creación de etiquetas y lanzamientos según 
las reglas de versionado semántico. Esto puede incluir la creación de etiquetas después de la fusión 
en una rama principal o la generación automática de lanzamientos en función de las versiones en tu 
proyecto. 
 
El uso de etiquetas y el versionado semántico en GitHub ayuda a mantener una estructura clara en 
tu proyecto, permitiendo a los colaboradores y usuarios entender las versiones y cambios con mayor 
facilidad.