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:

<syntaxhighlight> // 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" </syntaxhighlight>