- Une fonctionnalité qui permet d’ajouter des notes sans modifier les objets stockés dans git
- Généralement utilisée pour ajouter des métadonnées séparées à un commit
- Parce qu’il est possible de les ajouter / modifier / supprimer plus tard, même après le commit
- Elles sont stockées séparément par défaut dans
refs/notes/commits
- Avec
git log, elles apparaissent avec l’entrée Notes:
- Cas d’usage réels
- Dans le « projet git », elles servent à relier les commits aux fils de discussion de la mailing list correspondants
- Suivi du temps sur les commits / branches
- Enregistrement d’informations liées à la revue de code et aux tests
- Avec le plugin
reviewnotes pour Gerrit, il est possible d’enregistrer les revues de code dans des git notes
- Un développeur de Google a même créé un système complet de revue de code basé sur git notes, appelé git-appraise
- Il l’a baptisé « revue de code totalement distribuée »
- Il permet de faire localement des « demandes de revue / commentaires / revue et fusion »
- Il dispose aussi d’une interface web
- Mais personne n’utilise git notes
- À l’heure actuelle, git notes reste difficile à utiliser
- GitHub a cessé d’afficher les Notes depuis 2014
- Pour les commits, on peut utiliser
gitconfig pour voir et ajouter des notes plus facilement, mais ce n’est pas simple pour les blobs / trees
Indépendance vis-à-vis des forges
- git est un système de revue de code distribué. Mais une grande partie de la valeur d’un dépôt git reste enfermée dans des coffres comme GitHub
- git notes ouvre la voie à une alternative
- git distribue l’historique des fragments de code. git notes pourrait permettre de distribuer l’historique de l’ensemble du projet
1 commentaires
Je ne connaissais pas
git notes. Merci de l’avoir partagé.