¿Qué hace que un commit y un mensaje de commit sean buenos?

Question

Accepted Answer

Los buenos commits son **enfocados** (un cambio lógico) con **mensajes claros** que expliquen qué cambió y por qué. Los commits y mensajes bien elaborados hacen que el historial del proyecto sea legible, útil para entender cambios, depuración y colaboración.

## Buenos mensajes de commit

```text
GOOD message structure:
  Short summary line (~50 chars, imperative mood, capitalized, no period)
  <blank line>
  Optional body: explain WHAT and WHY (not how — the code shows how),
  wrap at ~72 chars. Reference issues if relevant.
```

```text
✅ GOOD:
  Add user email validation to registration form

Validate email format before submission to prevent invalid
  accounts. Fixes #142.

❌ BAD:
  "fixed stuff", "update", "asdf", "changes", "wip"
  → vague, uninformative — useless when reviewing history later
```

## La convención del modo imperativo

```text
Write the summary as a COMMAND/instruction (imperative):
  ✓ "Add feature", "Fix bug", "Update docs", "Remove dead code"
  ✗ "Added feature", "Fixes bug", "Updating docs"
→ Convention: it reads as "this commit will [Add feature]" (matches Git's own messages).
```

## Buenos commits: atómicos y enfocados

```text
✓ ATOMIC — each commit is ONE logical change (not many unrelated changes lumped together)
✓ Focused — "Add login" and "Fix typo" are SEPARATE commits, not one
✓ Working — ideally each commit leaves the code in a working state
Why: focused commits are easier to REVIEW, REVERT (undo one change cleanly),
  understand, and bisect (find which commit introduced a bug).
```

## Conventional Commits (un estándar popular)

```text
type(scope): description    → feat: add login | fix: handle null | docs: update README
  types: feat, fix, docs, refactor, test, chore, etc.
→ Enables automated changelogs/versioning; widely adopted in many projects.
```

## Por qué es importante

Entender qué hace que los commits y los mensajes de commit sean buenos es valioso para **crear un historial de proyecto legible y útil**, por lo que es un conocimiento práctico importante que afecta significativamente la colaboración y mantenibilidad. **Los buenos mensajes de commit** importan porque el historial de commits es una forma crucial de documentación — mensajes claros (un resumen conciso explicando *qué* cambió, con un cuerpo explicando *por qué* cuando es necesario) hacen posible entender cómo y por qué evolucionó el código, lo cual es invaluable al revisar historial, depuración (entender por qué se hizo un cambio) u onboarding.

Mensajes vagos ("arreglé cosas", "actualización", "wip") hacen que el historial sea inútil, imposibilitando entender cambios más tarde — un costo real.

La **convención del modo imperativo** ("Añadir feature" no "Añadido feature") es un estándar ampliamente seguido que vale la pena conocer. **Los buenos commits siendo atómicos y enfocados** (cada commit un cambio lógico, no muchos cambios no relacionados juntos) es igualmente importante: los commits enfocados son mucho más fáciles de **revisar** (los revisores entienden un cambio), **revertir** (deshacer un cambio limpiamente sin afectar otros), entender, y **bisect** (encontrar qué commit introdujo un bug) — entonces la estructura del commit afecta directamente qué tan usable es el historial para depuración y colaboración.

Conocer sobre **Conventional Commits** (el estándar `type(scope): description` habilitando changelogs y versionado automatizado) es valioso ya que es ampliamente adoptado.

Ya que el historial de commits es documentación importante y los buenos commits/mensajes lo hacen legible y útil (para entender, revisar, depuración y colaboración) mientras que los pobres lo hacen inútil, y ya que elaborar commits enfocados con mensajes claros es una marca distintiva de la práctica profesional de Git, entender qué hace que los commits y los mensajes de commit sean buenos es conocimiento valioso y prácticamente relevante para colaboración efectiva e historial mantenible — una habilidad que distingue a desarrolladores reflexivos y mejora significativamente la usabilidad a largo plazo de un proyecto y el flujo de trabajo del equipo.