Разделы документации

Карта владения

Кто знает код каждого репозитория, где знание держится на одном человеке и как Archepelag это считает.

Что это

Раздел Люди показывает, кто в каких репозиториях и продуктах работает и насколько хорошо знает этот код. Список людей открывается сразу, а кнопка Карта (или клавиша M) переключает его на граф: люди, репозитории и продукты, связанные линиями.

Линия соединяет человека с репозиторием, в который он писал код. Чем лучше человек знает код, тем сильнее связь.

Как считается знание кода

Для каждой пары «человек — репозиторий» Archepelag считает долю знания от 0 до 100% по истории git:

Что учитываетсяВес
Доля добавленных строк среди всех авторов репозитория30%
Доля коммитов25%
Насколько давно человек работал в репозитории25%
Доля затронутых файлов20%

Давность полностью засчитывается, если последний коммит был не раньше 90 дней назад, и плавно уменьшается до нуля к году без коммитов. Поэтому человек, который давно ушёл из проекта, со временем перестаёт считаться экспертом.

Данные собирает фоновый анализ Авторы и владение кодом — его можно запустить вручную на вкладке репозитория Анализ кода (меню Анализ) или включить по расписанию, см. Анализ кода и стек.

Фильтр «Связи» и активность

ФильтрЧто показывает
ВсеЛюбой вклад, даже один коммит — кто вообще касался кода
от 25%Человек заметно знает код; с этого порога он учитывается в bus factor
от 50%Один из основных авторов репозитория
от 80%Главный эксперт
Только активныеСвязи с коммитами за последние 90 дней

Режимы карты

  • Люди — кто в каких репозиториях работает. Размер точки человека — по числу его репозиториев: видно, кто разбросан по многим проектам.
  • Знания — насколько глубоко знают код. Чем сильнее знание, тем ярче линия; крупные точки — эксперты.
  • Риски — где знание держится на одном человеке. Красным подсвечены репозитории с bus factor 1 и линии к их главным экспертам, остальное приглушено.

Единственные владельцы

Bus factor на карте — число людей, которые знают репозиторий хотя бы на 25%. Если такой человек один и его доля от 80%, он единственный владелец: его уход оставит код без хозяина.

Список таких людей открывается представлением Единственные владельцы в проводнике слева, а в таблице у них стоит значок предупреждения. Колонка Макс. доля показывает самое сильное знание человека в каком-либо репозитории.

Клавиши

КлавишаДействие
MКарта ↔ список
Ctrl+PБыстрый переход к разделу, человеку или продукту
Ctrl+BСкрыть или показать проводник
/Поиск
↑ / ↓, EnterВыбрать человека и открыть его во вкладке