Карта владения
Кто знает код каждого репозитория, где знание держится на одном человеке и как 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 | Выбрать человека и открыть его во вкладке |