DeepGraph

Как начать работу с 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 пуста.

Что дальше