Question

Hola.

En la documentación oficial de git se recomienda utilizar el presente imperativo para los mensajes de commit. De forma que el mensaje sería por ejemplo "Fix bug #123" en lugar de "Fixed bug #123" o "Fixing bug #123".

La duda que tengo es si los que escribís los mensajes de commit en español seguís esta misma regla, es decir, ¿escribiríais como mensaje "Arreglar fallo #123"?

Y, en caso de escribir los commits utilizando otro tiempo verbal, ¿cuál utilizáis?

Un saludo.

Answer 1

Hola,

acá seguimos las reglas que sugiere git. Sin embargo las reglas no dicen que las oraciones valan en infinitivo como decís vos, sino en presente indicativo:

Implementa requerimiento 38.
Arregla bug #123

Estoy en ARgentina y acá usamos mucho spanglish, por eso escribimos "bug" y no "fallo"

Te desaconsejo los gerundios, porque decir:

Implementando requerimiento 38

sugiere que estás a medio trabajo con algo y desalienta a nuevos commits porque nadie quiere hacer una dolorosa revisión de código.

Igual, lo mejor es ponerse de acuerdo entre el equipo de desarrollo y hacer todos lo mismo, no importa lo que esto sea.

Saludos!

Answer 2

No me acuerdo como se llama el tiempo, en español México yo en lo personal utilizo:

Se solucionó fallo #123
Se corrigío un problema

pero si dices que es presente imperativo seria como:

Se soluciona fallo#123
Se corrige fallo #456

Answer 3

En primer lugar te recomiendo hacerlo en inglés (Los hispano-parlantes te seguirán entendiendo igualmente)

Si has arreglado el fallo, dado que esta acción ya ha ocurrido deberías utilizar el pasado

Fixed Bug #123 (Fallo/Error #123 corregido)

Si el problema esta por solucionar, normalmente no se suele decir a través de commit, se deja en el código comentado con un "por hacer" (normalmente no se suele traducir, se deja el TODO: y si quieres la explicación la dejas en español)

// TODO: Fix bug #123 (Por hacer: Corregir fallo/error #123)

No es muy común utilizar el gerundio (verbo -ing) ni el continuo (To be + verbo -ing), porque no se suele dar la información del proceso de desarrollo actual

Fixing bug #123 (Corrigiendo fallo/error #123)
We are fixing the bug #123 (Estamos corrigiendo el fallo/error #123)