За день до перфоманс-ревью вы открываете пустой документ и понимаете, что не помните квартал. Задачи слиплись в одно пятно, крупный рефакторинг вспоминается как «что-то делал в марте», а главное достижение вообще не попало в заметки. След работы при этом остался: пулл-реквесты, ревью, комментарии, коммиты. Просто лежит он в GitHub, а не в вашей голове.
ShowOffer — пет-проект, который вытаскивает эту статистику и раскладывает её по виджетам: графики, счётчики, сравнение с предыдущим периодом. Дальше — как из этого сделать нормальную подготовку к ревью и 1:1. И где цифры начинают врать.
Что внутри
Подключаетесь через read-only токен GitHub или GitHub-приложение. Если отдавать доступ не хочется, есть кнопка «Try with sample data» — посмотреть, как выглядит отчёт, на демо-данных.
Дальше выбираете период — квартал, полгода или год, — включаете или не включаете сравнение с предыдущим отрезком, отмечаете организации и репозитории. Скан занимает минуту-две. Регистрации нет, ставить ничего не надо.
Виджетов 28. Автор чаще всего держит на странице такие: слитые PR по месяцам; свои ревью чужих PR с исходом (approved, changes requested, commented); время до первого ревью и до мержа; крупнейшие PR; репозитории и языки; профиль вклада — PR, ревью, issue, коммиты, репозитории, streak с дельтой к прошлому периоду.
Виджеты двигаются мышкой, растягиваются, удаляются. Кнопка «Fit chosen widgets» раскладывает их по листу без дыр. Готовая страница выгружается в PNG, JPG, SVG или PDF в одном из пресетов: карточка, пост для соцсетей, половина страницы, полная страница.
Перфоманс-ревью: разговор про работу, а не про память
Сценарий, ради которого всё делалось. Вы приносите цифры за период, показываете, где был основной вклад, и отдельно — где его оказалось меньше. Обсуждение переезжает с «кажется, я много сделал» на конкретные PR и сроки.
Практическая деталь: делите разговор на две части. Сначала крупные штуки — два-три PR, которые вы сами считаете главными. Потом общая динамика. Если начать с графиков, беседа съедет в спор о метриках.
1:1 — тот же отчёт, другой масштаб
Для встреч один на один период короче: месяц или отрезок между встречами. Автор отмечает, что здесь показывает более гранулярные числа, чем на ревью — проще заметить, что упёрлись в чужой код и пора просить помощь, или наоборот, есть запас, чтобы взять больше задач.
Форма работы
Отдельная штука, которая вылезает не сразу. По графикам видно пропорцию между написанием кода и ревью, и меняется ли она от квартала к кварталу. Автор пишет, что при первом запуске обнаружил у себя больше ревью, чем предполагал. Такое наблюдение стоит проговорить с руководителем — это разговор про роль, а не про выработку.
Как читать метрики
Сам по себе ни один показатель ничего не доказывает. Смысл появляется, когда вы понимаете, что именно он измеряет и в какую сторону его трактовать.
| Показатель | Что показывает | Как читать |
|---|---|---|
| Слитые PR по месяцам | Ритм поставки | Ровная линия полезнее одного всплеска перед ревью |
| Время до первого ревью | Как быстро команда подхватывает ваши изменения | Растёт — возможно, PR стали слишком крупными или ревьюеров не хватает |
| Ревью, которые дали вы | Сколько чужого кода прошло через вас | Ценно, если доля approved не стопроцентная |
| Крупнейшие PR | Где была основная сложность | Хороший якорь для рассказа о конкретной задаче |
| Streak и число коммитов | Регулярность | Самый ломкий показатель: накручивается мелкими коммитами |
Чего цифры не говорят
Главная оговорка от автора инструмента: это не мера успеха. Это артефакт работы. Тренд важнее абсолютных значений — сравнение с прошлым периодом даёт больше, чем само число.
Дальше начинается ручная работа. Человек, который полгода чинил флаки-тесты, в графиках выглядит почти пусто: PR мелкие, строк мало. Менторство, разборы инцидентов, дизайн-документы и переговоры в отчёт не попадают вообще. Поэтому список того, чего в цифрах нет, пишите руками — до того, как откроете дашборд.
Типичные ошибки
- Приносить отчёт как доказательство «я молодец». Читается как попытка закрыться метриками вместо разговора о результатах.
- Сравнивать свои PR с чужими. У вас разные зоны ответственности, счётчик этого не знает.
- Брать слишком длинный период «для солидности». Полгода усредняет всё, квартал честнее показывает сдвиг.
- Гнаться за streak. Смысла в коммитах по пять минут ноль, а в графике они выглядят солидно.
И ещё одно: смотреть на один показатель в отрыве от контекста. Рост времени до первого ревью может значить, что PR стали крупнее, а может — что в команде просто мало ревьюеров. Это вопрос к руководителю, не к графику.
Чек-лист перед встречей
- Выберите период под цикл ревью: квартал к квартальному, полгода к полугодовому.
- Включите сравнение с предыдущим периодом.
- Выпишите два-три главных PR и сверьте с графиком — совпадает ли ваше ощущение с данными.
- Допишите то, чего в GitHub нет: наставничество, разборы инцидентов, документацию, ревью дизайна.
- Выгрузите страницу в PDF и положите рядом с документом по итогам. Через полгода не придётся собирать заново.
Про доступ и данные
Сайт статический, скан идёт в браузере. Токен остаётся во вкладке и уходит только на api.github.com. При входе через GitHub-приложение один запрос всё же идёт на сервер — завершить авторизацию, — но там ничего не сохраняется. Читаются заголовки, даты и счётчики; код не читается. На странице about описано, как проверить это в DevTools: открыть сетевую панель и посмотреть, куда уходят запросы.
Если и этого мало — начните с демо-данных. Отчёт будет чужой, зато видно, какие виджеты вообще нужны.
Что в итоге
Смысл затеи не в красивых графиках. Смысл в том, что разговор с руководителем переезжает с «мне кажется, я мало сделал» на конкретные примеры и динамику. Отчёт — черновик для разговора. Собрать его за десять минут перед встречей дешевле, чем полчаса вспоминать март.
Комментарии (0)
Войдите, чтобы комментировать.
Пока нет комментариев. Будьте первым.