Как создать пул реквест

Этот документ представляет собой краткое пошаговое руководство по созданию пул ревестов для Apollo. Вы также можете обратиться к GitHub: Using Pull Requests для более глубокого понимания.

Шаг 1: Форк вашей собственной копии ApolloAuto/apollo на свой аккаунт GitHub

Это делается нажатием кнопки «Форк» в правом верхнем углу страницы Apollo на GitHub и следуя инструкциям там.

Шаг 2: Клонируйте форк репозитория

Примечание:

Пожалуйста, замените «YOUR_USERNAME» на ваш аккаунт GitHub в описаниях ниже.

Откройте терминал и введите одну из следующих команд:

# Используя SSH
git clone git@github.com:YOUR_USERNAME/apollo.git

# Используя HTTPS
git clone https://github.com/YOUR_USERNAME/apollo.git

Шаг 3: Настройте ваше имя пользователя и адрес электронной почты для этого репозитория

git config user.name  "My Name"
git config user.email "myname@example.com"

Шаг 4: Установите официальный репозиторий Apollo как апстрим

Настройка апстрима позволяет синхронизировать изменения, сделанные в апстриме, с вашим собственным форком.

Это выполняется следующей командой:

# Используя SSH
git remote add upstream git@github.com:ApolloAuto/apollo.git

# Используя HTTPS
git remote add upstream https://github.com/ApolloAuto/apollo.git

Вы можете подтвердить, что апстрим репозиторий был добавлен, выполнив:

git remote -v

Если всё успешно, будет показан список удалённых серверов, похожий на следующий:

origin	git@github.com:YOUR_USERNAME/apollo.git (fetch)
origin	git@github.com:YOUR_USERNAME/apollo.git (push)
upstream	git@github.com:ApolloAuto/apollo.git (fetch)
upstream	git@github.com:ApolloAuto/apollo.git (push)

Шаг 5: Создайте новую ветку; внесите и зафиксируйте изменения

git checkout -b my_dev origin/master

# Внесите свои собственные изменения в ветке "my_dev"
# бла-бла...

# Зафиксируйте изменения в своей ветке с сообщением о коммите:
git commit -m "[модуль] краткое описание изменений"

Шаг 6: Синхронизируйте с апстримом ApolloAuto/apollo

git pull --rebase  upstream master

Шаг 7: Отправьте свои локальные изменения в свой форк

git push -f -u origin my_dev

Шаг 8: Создайте пул реквест

Создайте новый пул реквест между «Apolloauto/apollo:master» и «YOUR_USERNAME/apollo:my_dev», нажав кнопку «Pull Request» на странице вашего форка репозитория Apollo на GitHub.

Затем вы можете следовать шагам, описанным в GitHub: Creating a Pull Request, что делать дальше.

Примечание:

Пожалуйста, не забудьте добавить описание вашего PR. Это может помочь рецензентам лучше понять внесённые вами изменения и их цель.

Сотрудники нашей команды будут рады рассмотреть и объединить ваш коммит! (Это может занять некоторое время, пожалуйста, будьте терпеливы.)

Шаг 9: Готово!

Большое спасибо за ваш PR!