Превратите историю в граф Git.
Вставьте вывод git log, и LetDraw нарисует граф Git, который можно редактировать: по блоку на каждый коммит с коротким хешем и сообщением, имена веток и тегов на коммитах, на которые они указывают, и стрелки от каждого коммита к его родителям. Слияния и ветки наконец понятны с первого взгляда.
Как визуализировать историю Git
Одна команда в терминале, одна вставка в LetDraw.
Запустите git log с родителями
Для лучшего результата выполните git log --all --pretty=format:'%h %p%d %s', чтобы каждая строка содержала коммит, его родителей и имена его веток или тегов.
Вставьте его в «Создать из кода»
Откройте «Создать из кода» (функция Pro) в меню «Другие инструменты» и вставьте. Вывод git log распознаётся автоматически, и сразу появляется предпросмотр.
Выберите направление
Расположите коммиты сверху вниз или слева направо и переключайтесь между аккуратным и эскизным видом.
Вставьте и объясните
Поместите граф на холст, обведите важный коммит, добавьте заметки, затем поделитесь ссылкой или экспортируйте в PNG, SVG или PDF.
Граф Git, который можно редактировать, а не только смотреть
Коммиты с веткой или тегом показаны зелёным, коммиты слияния янтарным, остальные синим, а от каждого коммита идёт стрелка к каждому из его родителей. Результат состоит из обычных фигур LetDraw, поэтому перед тем как поделиться, можно отодвинуть ветку в сторону, выделить неудачное слияние или добавить стикер.
- Имена веток и тегов показаны на коммитах, на которые они указывают
- Коммиты слияния выделены, со стрелками к каждому родителю
- До 200 коммитов за одну вставку, линии --graph тоже принимаются
Когда картинка говорит больше, чем лог
Историю веток трудно объяснить словами и легко объяснить картинкой.
Онбординг
Покажите новым коллегам, как связаны main, релизные и feature-ветки в вашем настоящем репозитории.
Код-ревью
Приложите прямо к ревью картинку того, что содержит ветка и куда она будет слита.
Разбор запутанного слияния
Разложите коммиты вокруг инцидента и отметьте, где попало ошибочное изменение.
Заметки к релизу и документация
Покажите, какие коммиты попали между двумя тегами, и экспортируйте граф в PNG, SVG или PDF.
Стратегия ветвления
Сравните, как ваша команда ветвится на самом деле, с процессом, о котором вы договорились.
Обучение Git
Превратите демо-репозиторий в диаграмму и рисуйте на ней вживую, объясняя rebase и merge.
Граф Git: частые вопросы
Какой формат git log подходит лучше всего?
А как насчёт git log --oneline или --graph?
Покидает ли моя история браузер?
Это бесплатно?
Другие способы построить диаграмму из кода
Смотрите на свои ветки, а не только читайте о них.
Откройте LetDraw, вставьте git log и получите граф коммитов, который можно редактировать и показывать другим.