paint-brush
Convención de nomenclatura de sucursales de Git: 7 mejores prácticas a seguirpor@digitalverma
191,385 lecturas
191,385 lecturas

Convención de nomenclatura de sucursales de Git: 7 mejores prácticas a seguir

por Digital Verma3m2021/03/16
Read on Terminal Reader
Read this story w/o Javascript

Demasiado Largo; Para Leer

La convención de nomenclatura de ramas de Git admite el crecimiento orgánico de una base de código de forma sistemática. Ayuda a separar el trabajo estratégicamente. Hay una gran cantidad de convenciones y formatos recomendados, seguir los cuales podría ser una tarea desafiante. La convención de nomenclatura de ramas regulares es fácil y directa. Usando separadores de guiones o barras, los nombres se vuelven más difíciles de leer, creando confusión para el equipo. Evite las convenciones de nomenclatura simultáneas. Evitar combinar convenciones de nomenclatura solo genera complicaciones y hace que el proceso sea propenso a errores.

Company Mentioned

Mention Thumbnail

Coin Mentioned

Mention Thumbnail
featured image - Convención de nomenclatura de sucursales de Git: 7 mejores prácticas a seguir
Digital Verma HackerNoon profile picture

Una estrategia de bifurcación es una convención o un conjunto de reglas que especifican cuándo se crean las bifurcaciones.

Ayuda a los equipos y desarrolladores al describir las pautas de nomenclatura de las ramas y explica qué uso deberían tener las ramas, y así sucesivamente.

Debido a la falta de convenciones de nomenclatura adecuadas, el equipo de mantenimiento del código sufre numerosas confusiones y complicaciones.

La convención de nomenclatura de ramificación de Git admite el crecimiento orgánico de una base de código de manera sistemática. Ayuda a separar el trabajo estratégicamente.

Las dos amplias categorías de ramas de Git

1. Ramas Regulares

Disponible permanentemente en el repositorio, la convención de nomenclatura de las sucursales regulares es fácil y directa.

Desarrollo (Dev)

Dev, la rama de desarrollo principal, impide que los desarrolladores agreguen cambios directamente en la rama principal. Antes de fusionarse con el maestro, los cambios realizados en la rama de desarrollo se someten a revisiones y pruebas.

Maestro

La rama maestra es la rama predeterminada disponible en el repositorio de Git. Los miembros del equipo deben mantener la rama maestra estable y actualizada. Por lo general, es estable y no permite el check-in directo. La fusión es posible solo después de la revisión del código.

QA o rama de prueba

Esta rama contiene los códigos de control de calidad y las pruebas de automatización de los cambios implementados. Garantiza una base de código estable para el entorno de producción a través del proceso de prueba de control de calidad.

2. Ramas temporales de Git

Los miembros del equipo pueden crear y eliminar estas ramas cuando sea necesario.

  • Arreglo del fallo
  • Solución caliente
  • Ramas de características

Hay una gran cantidad de convenciones y formatos recomendados, seguir los cuales podría ser una tarea desafiante.

Las mejores prácticas de la convención de nomenclatura de ramas de Git

1. Comenzar el nombre de la sucursal con una palabra de categoría

Uno de los mejores métodos para mejorar la eficiencia es agregar una palabra que categorice la rama. La idea general es usar palabras cortas. La selección de palabras podría ser cualquier cosa que se adapte a su sistema de trabajo.

Use palabras de categoría como:

  1. WIP: trabajo en progreso y necesita su atención.
  2. Error: un error que debe corregirse de inmediato.

Con la ayuda de la palabra de categoría, es fácil identificar el propósito de la rama de Git y atenderlo.

2. Uso de identificaciones únicas de seguimiento de problemas en nombres de sucursales

Prefijos como; revisión, función, tarea o cualquier otra variante para categorizar una tarea, aumentar el trabajo que requiere más toma de decisiones al nombrar.

Con identificadores de seguimiento de problemas únicos, básicamente está marcando la categoría de la tarea en el seguimiento y agregando muchos contextos útiles.

Los desarrolladores trabajan principalmente en varios problemas en un momento dado, y un rastreador de problemas ayuda a conectar la rama de trabajo con las tareas relevantes. Hace que el seguimiento del progreso del equipo sea muy fácil.

El uso de una identificación de seguimiento de problemas externos en el nombre de la sucursal puede facilitar el seguimiento del progreso desde sistemas externos.

3. Uso de separadores de guiones o barras

La preferencia entre un separador de guiones, barras o guiones bajos se basa en su elección y la de su equipo. La idea es mantenerlo estrechamente consistente.

Sin los separadores, los nombres se vuelven más difíciles de leer, creando confusión para el equipo.

Usando separadores como guiones bajos, puede mejorar la legibilidad y hacer que el nombre sea más cómodo de manejar.

Los separadores son especialmente más significativos si se trata de una gran cantidad de sucursales.

4. Usar el nombre del autor en la rama de Git

Numerosas empresas utilizan esta técnica de agregar el nombre del autor a los nombres de las sucursales.

Este método ayuda a rastrear el trabajo de diferentes desarrolladores. Con más requisitos, también son posibles adiciones progresivas.

Ejemplo - name_feature_new-experimental-changes

5. Evite usar solo números

Usar solo números en el Id. de problema del nombre de la sucursal puede generar más confusión para el equipo.

Tal confusión durante el proceso de fusión de las ramas de Git puede generar muchos errores.

6. Evite la convención de nomenclatura simultánea

Mezclar o combinar convenciones de nomenclatura de ramas de Git solo genera complicaciones y hace que el proceso sea propenso a errores. La consistencia es un aspecto crítico, y el equipo debe mantener las convenciones decididas.

7. Evita los nombres largos

La precisión es el aspecto crucial de la denominación de ramas de Git. El nombre debe ser informativo y breve.

Los nombres largos y detallados solo generan confusión y afectan la eficiencia.

En lugar de wip_login_module_which_will_used_in_the_public_website, puede optar por wip_feature_login_module.

Las prácticas para la asignación de nombres de ramificación de Git son efectivas solo con el compromiso de una aplicación adecuada. El elemento crítico es que el equipo se mantenga en la misma página y sea consistente en todas partes.

Con el uso apropiado de las convenciones, usted y el equipo pueden mejorar notablemente la eficiencia y el flujo del trabajo.