Commits y branches con intención

Objetivo

Construir una historia revisable en vez de una carpeta de copias.

Explicación

Un commit debe ser pequeño y coherente. Una branch aísla una tarea. Antes de commit revisa git diff y git status; el mensaje explica la intención del cambio. Git y GitHub son parte del trabajo diario de un equipo de datos. No basta con memorizar comandos: debes ser capaz de dejar cambios pequeños, revisables y reproducibles, evitar secretos y explicar qué cambia un Pull Request antes de mezclarlo. Para trabajar Commits y branches con intención de forma profesional, no te quedes con el ejemplo: identifica la entrada, ejecuta el caso base, provoca al menos un caso incorrecto y compara el resultado con un control independiente. En este laboratorio el criterio de salida es concreto: git log –oneline muestra una historia donde cada commit tiene un propósito. La verificación principal será: git show de cada commit no mezcla cambios no relacionados. Si no puedes explicar por qué pasa esa comprobación, vuelve al paso anterior antes de continuar.

Contexto profesional

Git y GitHub son parte del trabajo diario de un equipo de datos. No basta con memorizar comandos: debes ser capaz de dejar cambios pequeños, revisables y reproducibles, evitar secretos y explicar qué cambia un Pull Request antes de mezclarlo.

Ejemplo real

git switch -c feature/customer-mart
git diff
git add models/marts/customer_revenue.sql
git commit -m "feat: add customer revenue mart"

Archivos o datos de entrada

• templates/README-template.md
• templates/.gitignore-data

Práctica guiada

Inicializa un repositorio con README y un SQL.

Laboratorio paso a paso

• Prepara el entorno y localiza los datos/archivos de entrada: templates/README-template.md, templates/.gitignore-data. Antes de modificar nada, anota el número de filas, columnas u objetos que esperas usar.
• Reproduce el ejemplo real de la lección y guarda la salida. No avances hasta poder explicar qué hace cada bloque relacionado con «Commits y branches con intención».
• Ejecuta la práctica guiada: Inicializa un repositorio con README y un SQL. Documenta el comando, consulta o acción exacta y el resultado obtenido.
• Resuelve el reto sin mirar la solución: Haz dos cambios distintos y sepáralos en dos commits. Si falla, registra el mensaje de error y formula una hipótesis antes de cambiar código.
• Compara tu resultado con el criterio esperado: git log –oneline muestra una historia donde cada commit tiene un propósito. Después ejecuta la comprobación: git show de cada commit no mezcla cambios no relacionados.
• Provoca deliberadamente un caso problemático relacionado con este error frecuente: Commits gigantes dificultan review y rollback.. Comprueba que sabes detectarlo y corregirlo.

Reto sin ayuda

Haz dos cambios distintos y sepáralos en dos commits.

Resultado esperado

git log –oneline muestra una historia donde cada commit tiene un propósito.

Cómo verificarlo

git show de cada commit no mezcla cambios no relacionados.

Checklist de validación

• El resultado cumple: git log –oneline muestra una historia donde cada commit tiene un propósito.
• Has ejecutado esta verificación y puedes explicar el resultado: git show de cada commit no mezcla cambios no relacionados.
• Has probado al menos un caso límite o dato inválido y el comportamiento es explícito, no silencioso.
• Puedes repetir la práctica desde cero sin copiar la solución y dejar evidencia (consulta, commit, captura o salida de consola).

Errores frecuentes

• Commits gigantes dificultan review y rollback.

Qué debes recordar

Un repositorio profesional permite entender, reproducir y revisar el trabajo.

Preguntas de entrevista

• ¿Qué debería contener un commit o PR para que sea revisable? Aplícalo concretamente a «Commits y branches con intención».
• ¿Cómo evitarías subir secretos o cambios accidentales al repositorio? Explica qué evidencia enseñarías al revisor.

Siguiente paso

Practicarás merge y conflictos.

Recursos de esta lección