Git notes: комментарий к коммиту без истории
git notes прикрепляет текст к коммиту, не меняя его хеш и историю. Заметки хранятся в отдельной ссылке refs/notes/commits, поэтому их можно добавить задним числом: результат ревью, причину отката, ссылку на тикет. В отличие от commit --amend, это не переписывает граф и не требует force push.
Добавить заметку и посмотреть её
git notes add -m "Reviewed-by: Анна" HEAD
git notes show HEAD
git log -1 --show-notesgit notes add создаёт заметку для указанного коммита; если заметка уже есть, команда завершится ошибкой. Используйте git notes append -m "..." для дописывания или git notes add -f для замены. git log --show-notes выводит заметки рядом с коммитами, а git notes show <commit> — только текст.
Отправить заметки на сервер
git push origin refs/notes/commits
git fetch origin refs/notes/commits:refs/notes/commitsОбычный git push не отправляет notes: это отдельная ссылка. После fetch коллеги увидят заметки, но должны знать о них — многие GUI не показывают их по умолчанию. Для ревью можно использовать отдельное пространство имён: git notes --ref=review add ... и пушить refs/notes/review.
Заметки не входят в подпись коммита и не защищают от изменения: их можно переписать и force-push, как любую ветку. Не храните в них секреты и персональные данные. При слиянии заметок возможны конфликты; git notes merge помогает свести версии, но автоматического разрешения нет.
Удалить заметку: git notes remove <commit>. Посмотреть все: git notes list. Заметки удобны для аудита и CI-метаданных, но не заменяют changelog или теги: они локальны для ссылки и не видны в обычном git log без флага.
Документация: git notes, notes в Pro Git.