freeCodeCamp/guide/russian/miscellaneous/how-to-make-a-pull-request-.../index.md

9.4 KiB
Raw Blame History

title localeTitle
How to Make a Pull Request on Free Code Camp Как сделать запрос на получение бесплатного кодового лагеря

Бесплатный запрос Camp Camp Pull

Что такое запрос Pull?

Запрос на выталкивание (PR) - это способ представления предлагаемых изменений в Repo Repo свободного кода (или любого Репо, если на то пошло). Вы внесете изменения в копии файлов, которые составляют Free Code Camp, в личной вилке, а затем примените их, чтобы они были приняты самим Free Code Camp.

Нужна помощь?

Free Code Camp Issue Моды и сотрудники готовы помочь с вопросами, связанными с Pull Request, в нашем чате Chat Help.

методы

Существует два метода создания Pull for Free Code Camp:

  1. Редактирование файлов через интерфейс GitHub
  2. Редактирование файлов на локальном клоне

Важно: ВСЕГДА РЕДАКТИРУЙТЕ НА ФИЛИАЛ

Уберите только одно из этого документа, это должно быть так: никогда, НИКОГДА не делайте изменения в staging ветку. ВСЕГДА создайте новую ветвь перед редактированием файлов. Это важно, потому что, если ваш PR не принят, ваша копия staging будет навсегда захудана, и единственный способ исправить это - удалить вилку и перекрёсток.

Редактирование через локальную вилку (рекомендуется)

Это рекомендуемый метод. Читайте о том, как настроить и поддерживать локальный экземпляр Free Code Camp .

  1. Выполните этап перебазирования обслуживания staging
  2. Убедитесь, что вы находитесь на staging ветке с использованием git status :

`
$ git статус
При организации филиала
Ваш филиал обновлен с помощью «origin / staging».

ничего не делать, рабочий каталог чист
`

  1. Если вы не находитесь в стадии постановки или ваш рабочий каталог не является чистым, разрешите любые выдающиеся файлы / фиксации и git checkout staging
  2. Создайте ветку от staging с git: git checkout -B branch/name-here Примечание: Именование наименований важно. Используйте имя, например, fix/short-fix-description или feature/short-feature-description Просмотрите Руководство по взносам для более подробной информации.
  3. Редактируйте свои файлы локально с помощью выбранного вами редактора
  4. Проверьте git status чтобы увидеть неустановленные файлы.
  5. Добавьте отредактированные файлы: git add path/to/filename.ext Вы также можете сделать: git add . для добавления всех неустановленных файлов. Будьте осторожны, потому что вы можете случайно добавить файлы, которые вы не хотите добавлять. Сначала проверьте свой git status .
  6. Зафиксируйте свои изменения: git commit -m "Brief Description of Commit"
  7. Сквош свои коммиты , если их больше одного.
  8. Нажимайте свои фиксации на свою вилку GitHub: git push -u origin branch/name-here
  9. Перейти к общим шагам

Редактирование через интерфейс GitHub

Примечание. Редактирование через интерфейс GitHub не рекомендуется, так как невозможно обновить вилку через интерфейс GitHub без удаления и повторного создания вилки.

  1. Создать вилку ретрансляции FCC
  2. Создайте ветку внутри своей вилки. Примечание. Именование наименований важно. Используйте имя, например, fix/short-fix-description или feature/short-feature-description Просмотрите Руководство по взносам для более подробной информации.
  3. Отредактируйте файл и зафиксируйте изменения.
  4. Перейдите к общим шагам.

Общие этапы

  1. После того, как изменения будут исправлены, вам будет предложено создать запрос на перенос на странице Github на вилке.
  2. По умолчанию все запросы на отгрузку должны выполняться против основного репозитория FCC, staging ветви.
  3. Сделайте четкий заголовок для своего PR, который кратко показывает, что фиксируется. Не добавляйте номер проблемы в заголовок. Примеры: Add Test Cases to Algorithm Drop It примеры Add Test Cases to Algorithm Drop It Correct typo in Challenge Size Your Images
  4. В теле вашего PR содержится более подробное изложение сделанных вами изменений и почему.
  5. Укажите, были ли вы протестированы на локальной копии сайта или нет.
  6. Если ваш PR вызван проблемой, вы можете автоматически ссылаться и закрывать эту проблему , добавив ключевое слово, например Closes #xxxx , где xxxx - номер проблемы.

Следующие шаги

Если требуются изменения

Не беспокойтесь, многие PR, особенно первые PR, требуют исправления или обновления. Если вы использовали интерфейс GitHub для создания своего PR, вам нужно будет закрыть свой PR, создать новую ветку и повторно отправить. Это связано с тем, что вы не можете раздавить свои коммиты через интерфейс GitHub.

Если у вас есть локальная копия репо, вы можете внести необходимые изменения и внести поправки в свой коммит: git commit --amend Это обновит вашу существующую фиксацию. Когда вы нажимаете его на свою вилку, вам нужно будет сделать силовой удар, чтобы перезаписать старый фиксатор: git push --force

Обязательно опубликуйте в PR-сообщении, что вы внесли требуемые изменения.

Если ваш PR принят

Как только ваш PR будет принят, вы можете удалить ветвь, созданную для ее отправки. Это позволяет вашей рабочей вилке очистить. Вы можете сделать это нажатием кнопки на PR-интерфейсе GitHub. Вы можете удалить локальную копию ветки с помощью: git branch -D branch/to-delete-name

Если ваш PR отклонен

Не отчаивайтесь! Вы должны получать надежную обратную связь от модераторов проблемы относительно того, почему она была отклонена и что необходимо. Пожалуйста, продолжайте участвовать.