Привет! Сегодня мы создадим пул-реквест и поговорим о ревью задач.

Немного отдохнём от командной строки и поработаем с интерфейсом гитхаба.

Откройте репозиторий в гитхабе. Теперь, если вы раскроете список веток (кнопка слева над файлами репозитория, на кнопке отображается название текущей ветки main), вы увидите рабочую ветку task-1-add-file. Переключитесь на неё: в списке файлов появился новый файл index.md. Это значит, что изменения успешно добрались до сервера.

Чтобы провести ревью, а потом влить внесённые изменения в проект, нужно создать запрос на слияние веток: Pull request.
1. В верхнем меню выберите пункт Pull requests. Страничка пока пустая, потому что мы не создали ни одного запроса;
2. Нажмите зелёную кнопку New pull request;
3. В разделе «Compare changes» выберите ветки:
В поле base нужно добавить ветку main, а в поле compare — ветку task-1-add-file.
Гитхаб проводит проверку возможности слияния и выносит вердикт: Able to merge. Значит, всё хорошо, конфликтов не обнаружено, можно создавать пул-реквест.
4. Найдите зелёную кнопку Create pull request и нажмите на неё;
5. Придумайте название и описание пул-реквеста: заполните поля Add a title и Add a description. Обычно в компаниях разработаны правила наименования пул-реквестов, но мы с вами не в обычной компании) Поэтому предлагаю придерживаться простой рекомендации: название должно кратко отражать суть задачи, а описание — подробности вносимых изменений.
Я назову пул-реквест «Добавление первого файла», а в описании расскажу, что именно я сделал: «Создал и добавил новый файл index.md».
6. Ещё раз нажмите кнопку Create pull request. Поздравляю, запрос создан!

Этот запрос нужен не только для того, чтобы слить ветки. Именно здесь может проходить процесс проверки задачи и внесение правок. Обычно ссылка на пул-реквест прикрепляется к задаче, и назначенный ревьюер приходит и проверяет вашу работу. Он может перейти на вкладку Files changed и посмотреть файлы, которые вы изменили, а также оставить комментарии к любой строке этих файлов. Эти комментарии будут отображаться на главной странице пул-реквеста, вы можете отвечать на них, ну, и конечно, вносить изменения по требованию ревьюера. После того, как все проверки будут пройдены, а правки согласованы, пул-реквест принимается и ваша рабочая ветка вливается в main, то есть добавляется в основной проект.

Слиянием мы займёмся чуть позже, а пока я предлагаю выполнить небольшое домашнее задание. Да, здесь опять нужно вернуться к командной строке.
Что нужно сделать
Внесите изменения в файл index.md и отправьте эти изменения на сервер.
Подсказка
Всю работу над задачей мы проводим в одной ветке. Если в процессе ревью вы получили правки, то вносить их нужно в той же рабочей ветке, а потом по уже знакомому пути отправить изменения на сервер (проиндексировать изменения → создать коммит → отправить коммит). Если всё сделано правильно, ваш новый коммит попадёт в уже созданный пул-реквест.
Ожидаемый результат
Файл index.md изменён, в пул-реквесте на вкладке Commits отображаются два коммита.

Я желаю вам удачи! По всем вопросам приходите в комментарии!

#практика #docsascode