Notes sans réécrire

git notes attache des métadonnées arbitraires à des commits existants sans changer leurs SHAs. Reviews, statuts de build, sign-offs, métriques de performance — tout ce que vous voulez associer à un commit peut vivre dans des notes. Elles sont stockées dans la ref spéciale refs/notes/commits par défaut.

Ajouter et éditer

git notes add -m "Revu par équipe Phoenix" <sha>
git notes append -m "QA passé" <sha>
git notes edit <sha>
git notes show <sha>
git notes remove <sha>

Utiliser des namespaces

git notes --ref=builds add -m "build #1234 OK" <sha>
git notes --ref=reviews add -m "LGTM" <sha>
git config notes.displayRef "refs/notes/*"

Afficher dans log

git log --notes
git log --show-notes=builds
git log --pretty=format:'%h %s%n%N' --notes

Partager les notes

git config --add remote.origin.fetch '+refs/notes/*:refs/notes/*'
git fetch
git push origin 'refs/notes/*'

Cas d'usage : annotations CI

git notes --ref=ci add -m "duration=312s status=pass coverage=87%" <sha>
git push origin refs/notes/ci

Merger des notes

git notes merge -s union refs/notes/origin/commits

Erreurs courantes

S'attendre à ce que les notes voyagent automatiquement avec git push — elles ne le font pas.