Годовое ревью пишут по памяти. Память при этом хранит последние месяца два: июньская миграция чекаута вспоминается ярче, чем то, чем вы занимались в феврале. Дальше пробелы заполняет менеджер — своими впечатлениями. Git помнит точнее: у каждого пулл-реквеста есть название, дата, размер и ревьюер.
Командные метрики в личное ревью тащить не стоит. Здесь другое: свои собственные числа нужны вам самому — как поисковый инструмент по году.
Одно утверждение — одно проверяемое число
Работающая фраза собирается из трёх частей: что сделали (одно предложение), число, которое любой может проверить, и объяснение, почему это было важно. Без числа утверждение повисает.
«Я много помогала с ревью» — это не утверждение, а ощущение.
«Я отревьюила 246 чужих PR против 160 в прошлом году, в основном в payments-api. Медианное время до первого ревью — 2.6 часа» — с этим уже можно работать.
Оценку из этих чисел делать не надо. Они нужны как поисковый инструмент по собственному году: сначала находите аномалии, потом вспоминаете истории.
Шаг 1. Сравните период с предыдущим
Абсолютное значение само по себе молчит. 112 смерженных PR — много или мало? Понятно только рядом с прошлым годом. Вот как выглядит такая таблица (цифры учебные, для вымышленного инженера Jordan Vale):
| Метрика | Прошлый период | Текущий | Изменение |
|---|---|---|---|
| Смержено PR | 88 | 112 | +27% |
| Ревью чужих PR | 160 | 246 | +54% |
| Время до мержа | 26 ч | 18.5 ч | −29% |
| Время до первого ревью | 5.1 ч | 3.8 ч | −25% |
| Средний размер PR | 268 строк | 212 строк | −21% |
| Доля смерженных PR | 93% | 95% | +2 п.п. |
Дальше смотрите на самые крупные сдвиги и по каждому задаёте вопрос «почему». Ответ — это и есть абзац ревью. Рост ревью объясняется просто: пришли новые люди или вы стали вести направление. Ускорение мержа, скорее всего, следствие последней строки: мелкие PR проверяются быстрее.
Падение — не всегда плохо. Меньше PR может значить, что квартал ушёл на дизайн-документ. Так и напишите.
Шаг 2. Разложите год по месяцам
Итоговая цифра прячет время. 112 PR — это может быть ровный год, а может один очень занятый июнь. На помесячном графике видно и то и другое: в разобранном примере значения гуляют между 6 и 12, пик — 12 в июне, и почти каждый месяц текущий год выше прошлого.
Пик разбирается одним действием: открыть список PR за этот месяц и вспомнить, что выкатили. Провалы тоже требуют объяснения — отпуск, дежурство, онбординг. Провал с причиной читается нормально, провал без причины выглядит как просадка.
Шаг 3. Выберите несколько больших PR и раскопайте каждый
Значимая работа часто оставляет крупный PR. Выпишите четыре-пять самых больших по числу изменённых строк — в примере это миграция чекаута на server components (4 150 строк), двойная запись в бухгалтерском ядре (3 600), оркестрация ретраев для карточных сетей (2 570) и пайплайн токенов со сборкой темы (2 175). По каждому ответьте: что было до, что стало после, какой результат можно измерить. Результат берите из дашбордов и продуктовых метрик, не из git — git не знает, ускорился ли чекаут.
Осторожно с размерами: lock-файлы и сгенерированные файлы раздувают счётчик строк и превращают рутину в «миграцию на 4 000 строк». Такие строки из списка выкидывайте.
Шаг 4. Посчитайте тихую работу
Ревью, разборы, ответы на вопросы — то, что не попадает ни в один релиз, но съедает половину недели. Здесь хорошо работают два числа вместе: сколько ревью вы отдали на один собственный PR (в примере — 2.2, то есть вдвое больше, чем смержили сами) и как быстро отвечали (медиана 2.6 часа). Одного предложения хватает на весь блок: «На каждый свой PR я делала два ревью коллегам, обычно в течение трёх часов».
Из той же выборки: 58% ревью закончились аппрувом, восемь репозиториев, 61 закрытый issue. В текст попадёт не всё, но держать под рукой полезно.
Тонкость: ревью считаются по PR, а не по комментариям. Один PR с пятью раундами правок — это одно ревью.
Чего git не видит
Git видит код. Остальное придётся собирать руками — коротким списком в течение года, а не за вечер перед ревью:
- дизайн-документы и RFC;
- менторство и онбординг новичков;
- инциденты и постмортемы;
- клей-ворк: планирование, разблокировка соседних команд, документация (подробно об этом в докладе Tanya Reilly про glue work).
И оговорки, без которых числа врут:
- приватные репозитории видны только токену с подходящими правами;
- squash-мержи и прямые пуши в main меняют счётчик коммитов — по PR считать стабильнее;
- парная работа часто приземляется под одним именем. Скажите об этом прямо, иначе половина вклада исчезнет.
Что приложить к ревью
Одну страницу с ключевыми числами и графиком по месяцам — истории и так уйдут в текст формы. Отчёт собирается руками или генератором: встречаются инструменты, которые читают GitHub по read-only токену и строят такие таблицы, но метод от инструмента не зависит. Минимальный вариант — поисковый запрос вида is:pr author:YOU merged:2025-11-01..2026-10-31: он даст счётчик смерженных PR за период.
Чек-лист перед отправкой:
- у каждого утверждения есть число или ссылка;
- период сравнён с предыдущим;
- провалы по месяцам объяснены;
- у каждого крупного PR есть «до», «после» и результат;
- ревью и прочая тихая работа посчитаны;
- некодовая работа вынесена в отдельный раздел.
Само по себе число ничего не доказывает: сотня PR подряд может быть одним и тем же багфиксом. Смысл упражнения в другом — git даёт зацепки, а историю рассказываете вы. Менеджеру нужен не график, а объяснение, почему год получился именно таким.
Комментарии (5)
Войдите, чтобы комментировать.