Estándar para documentación de Commits

Este estándar se establece con la intención de generar documentación de utilidad al momento de registrar commits en los repositorios GIT.

Los pasos para adaptarse al estándar son los siguientes:

1. Estandarizar el usuario con el que están apareciendo los commits en el [SCM Manager].
2. Documentar los commits de acuerdo al estándar establecido.

Cambiar usuario y correo con el que se registran los Commits

Dado que en muchos casos se usa *GitHub Desktop* como cliente Git, en los repositorios clonados queda seteado un usuario asociado a la plataforma de GitHub, el cual es distinto del usuario corporativo asignado para el SCM Manager.

Es por ello que se hace necesario verificar que el usuario con el que se están realizando los commits en el repositorio es el corporativo, por ejemplo:

Para el usuario corporativo rbabilonia el correo asociado es rbabilonia@telstock.net

Por lo que los commits deben aparecer firmados como: Robert Babilonia <rbabilonia@telstock.net> y no con cualquier otra cuenta o correo electrónico.

Para verificar el usuario con el que se están firmando los commits, ejecutar el los siguientes comandos desde una consola en el directorio raíz del proyecto Git:

git config --global --list

Esto retornará la lista de configuraciones globales asociadas a Git:

Configuraciones globales de Git

Nota: Si el nombre y correo están seteados correctamente en estas variables, verifique la configuración particular para el repositorio del proyecto desde el que realiza la consulta, para ello ejecute:

 git config --list

Parametros de configuración asociados al repositorio Git

Esto retornará los parámetros de configuración asociados al repositorio.

Donde los parámetros mas importantes serán:

user.email

user.name

Si en alguno de los casos el usuario o correo no están correctamente configurados, los puede corregir con las siguientes lineas desde el batch:

// Para configurar nombre y correo de forma global
git config --global user.name 'John Doe'
git config --global user.email 'john@doe.org'
//Para configurar nombre y correo solo para el repositorio desde donde se ejecuta este comando
git config user.name 'John Doe' 
git config user.email 'john@doe.org'

Registrar commits según el estándar Telstock

La información de los commits es importante para poder llevar un mejor control de las actividades y niveles de productividad de los participantes de un proyecto. Es por ello que se ha definido el siguiente estándar para garantizar que se dispone de la información mínima necesaria.

Todo commit en Git debe llevar un mensaje asociado, este mensaje debe tener la siguiente estructura:

[Código Mantis o Jira] - [Mensaje descriptivo]

Donde [Código Mantis o Jira] debe ser sustituido por el código de la actividad asociada en el Jira o el número del ticket en el Mantis:

Ejemplo para Jira:

Nomenclatura en Jira

Como se observa en la imagen, el código de la actividad asociada es DCDBM-21, por lo que el mensaje de commit correspondiente sería:

 DCDBM-21 - [Mensaje descriptivo]

Ejemplo para Mantis:

Nomenclatura de Tickets en Mantis

Para este ejemplo, el ticket de Mantis asociado es el 111, por lo que el mensaje de commit correspondiente sería:

 MANTIS-111 - [Mensaje descriptivo]

Finalmente, el mensaje asociado a un commit debe verse similar a este:

git commit -m 'DCDBM-21 - Mensaje de prueba para documentar estándar de mensajes de Commits en repositorios'