Push

Que fait Push ?

Effectuez un commit et poussez les modifications sur la branche courante.

Cette compétence n'est pas restreinte à une branche particulière — elle fonctionne toujours sur la branche actuellement extraite. Adaptez la ligne de « trailer » à l'étape 8 ci-dessous selon la convention d'attribution de commit de votre projet.

Démarrage rapide

1. Détectez la branche courante avec git branch --show-current.
2. S'il n'y a pas de nom de branche courante, arrêtez-vous et signalez l'erreur.
3. Tirez la dernière version de origin/<branche-courante> avec git pull --ff-only origin <branche-courante>. Si cela échoue, arrêtez-vous et signalez l'erreur.
4. Inspectez le diff avant de staged.
5. Préférez la mise à jour la plus récente et significative dans docs/change-log.md comme source du message de commit lorsque c'est pertinent.
6. Si aucune mise à jour du change-log n'est la source réelle de la modification, dérivez le message à partir de la zone primaire modifiée dans le diff.
7. Stagedez toutes les modifications avec git add -A.
8. Commitez avec un message multiligne et ajoutez le trailer standard du projet (généralement une ligne Co-Authored-By: ou une attribution similaire ; spécifique au projet).
9. Poussez avec git push origin <branche-courante>.
10. Rapportez la branche, le hash du commit et le sujet en une phrase.

Conseils pour le message de commit

Utilisez un sujet concis de style conventionnel, par exemple :

• docs: pour les mises à jour de documentation ou de routage
• feat: pour les nouvelles fonctionnalités, systèmes ou contenus
• fix: pour les corrections de comportement
• refactor: pour les changements structurels sans changement majeur de comportement
• test: pour les ajouts ou révisions significatifs de la couverture de test
• chore: pour les travaux de maintenance qui ne correspondent pas mieux ailleurs

Pour le corps :

• résumez les zones modifiées les plus significatives
• préférez 1 ligne par modification majeure
• restez ancré dans le diff réel

Lorsque vous utilisez docs/change-log.md comme source :

• préférez la section ou l'entrée la plus récente et significative qui décrit réellement la modification principale
• ne forcez pas un message dérivé du change-log lorsque la mise à jour du log est accessoire

Lorsque vous n'utilisez pas le change-log comme source :

• dérivez le sujet de la zone modifiée la plus importante dans le diff
• si le diff est trop ambigu pour être résumé en toute confiance, demandez le message de commit à l'utilisateur au lieu de deviner

Règles

• Utilisez toujours la branche actuellement extraite.
• N'utilisez jamais --force ou --force-with-lease.
• N'utilisez jamais --no-verify.
• Échouez fort : si une étape échoue, arrêtez-vous et signalez l'erreur.