El diff ya te dice qué

Un mensaje de commit que dice "Actualizado el controlador de usuario" son bytes desperdiciados — git diff ya muestra que el controlador de usuario fue actualizado. La parte valiosa es el por qué.

El formato de siete reglas

• Separa el asunto del cuerpo con una línea en blanco.
• Limita el asunto a 50 caracteres.
• Capitaliza el asunto.
• No termines el asunto con un punto.
• Usa el modo imperativo ("Fix bug", no "Fixed bug").
• Envuelve el cuerpo a 72 caracteres.
• Usa el cuerpo para explicar qué y por qué, no cómo.

Un ejemplo

git commit -m "Reject negative quantities in checkout

Los clientes podían enviar cantidades negativas editando el DOM,
lo que aplicaba créditos al total del pedido. Añadimos validación
en el lado servidor en CheckoutValidator porque las verificaciones
solo del lado cliente son insuficientes contra clientes con scripts."

Conventional Commits

git commit -m "feat(checkout): reject negative quantities"
git commit -m "fix(auth): handle expired refresh tokens"
git commit -m "docs(readme): clarify install steps"

Las plantillas lo hacen automático

cat > ~/.gitmessage 'EOF'
# Asunto (máx 50 caracteres)

# ¿Por qué es necesario este cambio?

# ¿Cómo aborda el problema?

# Efectos secundarios, seguimientos, enlaces?
EOF
git config --global commit.template ~/.gitmessage

Referenciar issues

git commit -m "Fix avatar upload race condition

See: PROJ-2207
Co-authored-by: Alex Tan "