Skip to content

Instantly share code, notes, and snippets.

@ComradeMashkov
Last active October 31, 2023 23:44
Show Gist options
  • Save ComradeMashkov/c2bc1801552284c2b43b8aabaef1bae3 to your computer and use it in GitHub Desktop.
Save ComradeMashkov/c2bc1801552284c2b43b8aabaef1bae3 to your computer and use it in GitHub Desktop.
Гайд по ТРПО (пулл-реквесты)

Как работать в команде?

Салют! Этот гайд посвящается основной вещи, которая позволяет вести работу в команде — пулл-реквестам. Пулл-реквесты (pull-requests) позволяют вести командную работу при помощи Git’a и сайта GitHub, а именно позволяют объединять наработки всех людей в один репозиторий.

В этой статье мы научимся делать пулл-реквесты на примере нашего репозитория, с которым мы будем работать весь семестр.

Для начала переходим в репозиторий проекта по этой ссылке и нажимаем на кнопку “Fork”.

1.png

У вас откроется небольшое меню. Все что надо сделать тут — это нажать на кнопку “Create fork”.

2.png

Отлично! Мы форкнули репозиторий (т.е. буквально — создали “вилку” или ответвление). Теперь этот репозиторий числится в списке репозиториев на вашем аккаунте и мы можем с ним работать.

Далее нам необходимо сгенерировать SSH-ключ, который даст понять GitHub’у, что именно ваш компьютер может работать с вашим аккаунтом.

Открываем консоль Git Bash (через пуск, чтобы консоль открылась в корне) и пишем следующую команду:

ssh-keygen

3_4_5_6.png

После ввода этой команды вы должны несколько раз нажать Enter до тех пор, пока ввод не кончится и на экране не появится красивая картинка (как на примере выше).

SSH-ключ сгенерирован. Теперь переходим по директории, где был помещен этот ключ и выводим его содержимое на экран:

cd .ssh/ # переходим по пути ключа
cat id_rsa.pub # выводим содержимое файла id_rsa.pub на экран

3.png

Мы должны скопировать все, что выдала команда cat (т.е. от ssh-rsa и до последнего символа включительно) и перейти по этой ссылке.

В поле “Title” вводим любое название на латинице, а в поле “Key” вставляем скопированный ssh-ключ. Нажимаем “Add SSH key”.

4.png

Переходим на сайт своего форкнутого репозитория (нажимаем на иконку вашего пользователя на гитхабе → кнопка “Your repositories” и жмем на airborne-crew). Нажимаем на зеленую кнопку “Code”, затем на надпись “SSH”, затем на иконку файлика и копируем SSH-ссылку на репозиторий.

5.png

Теперь создаем в любом удобном месте папку, где будет наш репозиторий и открываем ее через Git Bash (надеюсь, вы уже знаете как это делать). После того, как открыли, пишем следующую команду:

git clone SSH-ссылка

6.png

Теперь убедимся, что весь репозиторий сохранился на наш компьютер:

cd airborne-crew/ # переходим в подкаталог airborne-crew/
ls # выводим список файлов в этом подкаталоге - должно вывестись LICENSE и README.md

7.png

Далее пишем следующую команду:

code README.md # открываем в VS Code файлик README.md

В VS Code у вас должен открыться этот файл. В нем по пунктам вы пишите свою фамилию и имя. Обязательно сохраняем, нажав Ctrl + S.

8.png

После этого мы можем убедиться в том, что вы изменили файл:

git status # выведет в консоль состояние текущих файлов
# modified - значит изменен

9.png

Перед пулл-реквестом нам необходимо задать гиту вашу почту. Пишем следующую команду:

git config --global user.email "ваша-почта@почта.сру"

10.png

Теперь приступаем к коммиту (т.е. к тому, чтобы изменения на вашем компьютере перенеслись в репозиторий). Пишем следующий список команд:

git add README.md # добавляем файл README.md в список коммита
git commit -m "TEXT" # делаем коммит с комментарием "TEXT"
git push -u origin main # загружаем все в репозиторий

# прим.: команду git push -u origin main надо написать только первый раз
# в следующий раз можно просто написать git push

11.png

Теперь заходим по ссылке форкнутого репозитория (ВАЖНО! не мой репозиторий, а именно ваше ответвление, которое вы сохранили себе на гитхаб во вкладку “Your repositories”). Нажимаем на кнопку “Contribute” (1), затем на кнопку “Open pull request” (2).

12.png

После этого у вас откроется меню, в котором вы сможете оставить более подробный комментарий. Наконец, жмем на кнопку “Create pull request”.

13.png

Готово! Не забудьте добавить репозиторий в избранное, чтобы вы отображались во вкладке “контрибьютеры”.

14.png

@ComradeMashkov
Copy link
Author

1
2
3
3_4_5_6
4
6
7
8
9
10
11
12
13
14

@ComradeMashkov
Copy link
Author

5

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment