Как начать работу с DeepGraph
Это руководство шаг за шагом ведёт от проекта к первому отчёту. Отчёты пока показаны на английском, поэтому названия кнопок в отчёте даны так, как они выглядят на экране.
- Что нужно: браузер. Для примера или публичного проекта больше ничего. Для частных проектов войдите через GitHub, GitLab или Bitbucket. Для проектов на компьютере подойдёт любой аккаунт, в том числе созданный по адресу почты.
- Время: несколько минут. Примеры открываются сразу. Большой проект читается дольше.
Хотите посмотреть видео? DeepGraph за 90 секунд показывает, как публичный проект становится отчётом, а затем люди, команды и сравнения. Видео на английском, открывается на YouTube.
1. Добавьте проект
Откройте главную страницу DeepGraph и выберите способ:
- Пример: нажмите Pocket Notes, Harbor Shop или Meridian Platform под полем проекта. Это готовые отчёты о вымышленных людях, поэтому аккаунт не нужен. Пример открывается сразу: переходите к шагу 3.
- Публичный проект: вставьте ссылку на него с GitHub, GitLab или Bitbucket в поле проекта. Подойдёт и ссылка на файл или папку внутри него.
- Ваши проекты: войдите и выберите из проектов, к которым у вас есть доступ. Для GitHub установите приложение DeepGraph GitHub App и выберите проекты, которые оно может читать. Для GitLab нужна как минимум роль Reporter в проекте, чтобы видеть его показатели DORA. Для Bitbucket, если режим DORA попросит, подключите Bitbucket снова, чтобы DeepGraph мог читать запросы на слияние и конвейеры.
- Проект на компьютере: войдите, нажмите на скрепку с подписью .git и выберите папку. Как работает локальный анализ.
Что вы увидите: проект в виде плашки в поле проекта. Добавьте ещё, если хотите читать несколько проектов вместе.
2. Запустите отчёт
Нажмите кнопку со стрелкой в поле проекта. Ход работы виден вокруг поля и рядом с каждым проектом.
Что вы увидите: отчёт откроется, когда будет готов. Длинная история читается дольше.
3. Посмотрите на людей
В списке все, кто сохранял изменения, с их коммитами, добавленными и удалёнными строками и изменёнными файлами. Коммит — это один сохранённый набор изменений.
- Найдите человека и откройте его профиль.
- Переключайтесь между списком и сеткой, сортируйте по любому числу.
- Если один человек показан дважды, объедините его профили (кроме примеров, которые нельзя менять).
Что вы увидите: один профиль на человека с его активностью во времени. Подробнее о профилях участников.
4. Откройте день
Выберите период над графиком, затем нажмите на загруженный день. Выберите человека, чтобы увидеть его коммиты за этот день, и откройте коммит, чтобы увидеть, что изменилось.
Что вы увидите: файлы и строки за суммами. Большое число может означать новую функцию, уборку кода или созданные автоматически файлы. Изменения подскажут, что именно. Подробнее об активности коммитов во времени.
5. Объедините людей в команды
В своём отчёте выберите несколько человек, нажмите New team (новая команда) и перетаскивайте команды друг в друга, чтобы повторить, как вы работаете. Примеры можно читать, но не менять. В Meridian Platform команды уже есть.
Что вы увидите: суммы каждой команды и небольшой график её работы. Подробнее о командах.
6. Сохраняйте отчёты
Войдите, чтобы отчёты оставались на боковой панели. Складывайте связанные проекты в папки.
- Подключённые проекты могут обновляться, когда изменения попадают в их основную ветку, если ваше подключение разрешает уведомления об обновлениях.
- У публичного проекта, добавленного по ссылке, рядом с названием есть кнопка Sync (обновить).
- Локальные проекты обновляются, когда вы анализируете их снова.
Новые аккаунты получают 14-дневный пробный период Core без платёжных данных. См. помощь по оплате и цены.
Если чего-то не хватает
- Подключённого проекта нет в списке: проверьте, что у вашего аккаунта есть к нему доступ. Для GitHub проверьте, какие проекты может читать приложение DeepGraph GitHub App.
- Локальный проект не найден: убедитесь, что в папке есть скрытая папка .git и что браузер может её прочитать.
- Вкладка DORA пуста: см. почему вкладка DORA пуста.