Mantenir un historial de commits net i organitzat és essencial per a la col·laboració efectiva i la gestió de projectes a llarg termini. Un historial net facilita la comprensió dels canvis realitzats, la depuració de problemes i la revisió de codi. En aquesta secció, explorarem diverses tècniques i millors pràctiques per mantenir un historial de commits net.

Un bon missatge de commit és clar, concís i informatiu. Ha de proporcionar suficient context perquè altres desenvolupadors entenguin el canvi sense haver de llegir el codi.

• Línia de capçalera: Resum breu del canvi (màxim 50 caràcters).
• Línia en blanc: Separació entre la capçalera i el cos.
• Cos del missatge: Descripció detallada del canvi, si és necessari (màxim 72 caràcters per línia).

Els commits atòmics són petits i enfocats a un sol canvi o millora. Això facilita la revisió de codi i la identificació de problemes.

• Un commit per funcionalitat: Cada commit ha de representar un canvi lògic complet.
• Evitar commits massius: No incloure múltiples canvis no relacionats en un sol commit.

El rebase permet reescriure l'historial de commits per fer-lo més net i lineal. Això és especialment útil per netejar commits de desenvolupament abans de fusionar-los a la branca principal.

• Rebase interactiu: Permet editar, combinar o eliminar commits.

On n és el nombre de commits que vols reescriure.

El squash combina múltiples commits en un de sol, ideal per netejar l'historial abans de fusionar branques.

• Durant un rebase interactiu: Canvia pick per squash en els commits que vols combinar.

• Durant una fusió: Utilitza l'opció --squash.

El cherry-pick permet aplicar commits específics d'una branca a una altra, mantenint l'historial net i controlat.

Evita fer commits temporals o de treball en progrés (WIP) a la branca principal. Utilitza branques de característiques o git stash per emmagatzemar canvis temporals.

Per recuperar els canvis:

Practicar la creació de commits atòmics i l'ús de git rebase per mantenir un historial net.

1. Crea una nova branca:

2. Fes diversos canvis petits i crea commits atòmics:

3. Utilitza git rebase per combinar els commits:

4. Canvia pick per squash en el segon commit i guarda els canvis.

Després de fer el rebase, l'historial hauria de mostrar un sol commit amb els canvis combinats.

Mantenir un historial de commits net és crucial per a la col·laboració i la gestió de projectes. Utilitzant bons missatges de commit, commits atòmics, i eines com git rebase i git squash, pots assegurar-te que l'historial del teu projecte sigui clar i fàcil de seguir. Practica aquestes tècniques regularment per millorar la qualitat del teu codi i la col·laboració amb el teu equip.