85 lines
9.4 KiB
Markdown
85 lines
9.4 KiB
Markdown
---
|
||
title: How to Make a Pull Request on Free Code Camp
|
||
localeTitle: Как сделать запрос на получение бесплатного кодового лагеря
|
||
---
|
||
# Бесплатный запрос Camp Camp Pull
|
||
|
||
**Что такое запрос Pull?**
|
||
|
||
Запрос на выталкивание (PR) - это способ представления предлагаемых изменений в Repo Repo свободного кода (или любого Репо, если на то пошло). Вы внесете изменения в копии файлов, которые составляют Free Code Camp, в личной вилке, а затем примените их, чтобы они были приняты самим Free Code Camp.
|
||
|
||
## Нужна помощь?
|
||
|
||
Free Code Camp Issue Моды и сотрудники готовы помочь с вопросами, связанными с Pull Request, в нашем [чате Chat Help.](https://gitter.im/FreeCodeCamp/Contributors)
|
||
|
||
## методы
|
||
|
||
Существует два метода создания Pull for Free Code Camp:
|
||
|
||
1. Редактирование файлов через интерфейс GitHub
|
||
2. Редактирование файлов на локальном клоне
|
||
|
||
## Важно: ВСЕГДА РЕДАКТИРУЙТЕ НА ФИЛИАЛ
|
||
|
||
Уберите только одно из этого документа, это должно быть так: никогда, НИКОГДА не делайте изменения в `staging` ветку. ВСЕГДА создайте новую ветвь перед редактированием файлов. Это важно, потому что, если ваш PR не принят, ваша копия `staging` будет навсегда захудана, и единственный способ исправить это - удалить вилку и перекрёсток.
|
||
|
||
## Редактирование через локальную вилку (рекомендуется)
|
||
|
||
Это рекомендуемый метод. Читайте о том, [как настроить и поддерживать локальный экземпляр Free Code Camp](http://forum.freecodecamp.com/t/how-to-fork-and-maintain-a-local-instance-of-free-code-camp/19116) .
|
||
|
||
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` Просмотрите [Руководство](https://github.com/FreeCodeCamp/FreeCodeCamp/blob/staging/CONTRIBUTING.md) по [взносам](https://github.com/FreeCodeCamp/FreeCodeCamp/blob/staging/CONTRIBUTING.md) для более подробной информации.
|
||
3. Редактируйте свои файлы локально с помощью выбранного вами редактора
|
||
4. Проверьте `git status` чтобы увидеть неустановленные файлы.
|
||
5. Добавьте отредактированные файлы: `git add path/to/filename.ext` Вы также можете сделать: `git add .` для добавления всех неустановленных файлов. Будьте осторожны, потому что вы можете случайно добавить файлы, которые вы не хотите добавлять. Сначала проверьте свой `git status` .
|
||
6. Зафиксируйте свои изменения: `git commit -m "Brief Description of Commit"`
|
||
7. [Сквош свои коммиты](http://forum.freecodecamp.com/t/how-to-squash-multiple-commits-into-one-with-git/13231) , если их больше одного.
|
||
8. Нажимайте свои фиксации на свою вилку GitHub: `git push -u origin branch/name-here`
|
||
9. Перейти к общим шагам
|
||
|
||
## Редактирование через интерфейс GitHub
|
||
|
||
**Примечание.** Редактирование через интерфейс GitHub не рекомендуется, так как невозможно обновить вилку через интерфейс GitHub без удаления и повторного создания вилки.
|
||
|
||
1. Создать вилку ретрансляции FCC
|
||
2. [Создайте ветку](https://help.github.com/articles/creating-and-deleting-branches-within-your-repository/) внутри своей вилки. Примечание. Именование наименований важно. Используйте имя, например, `fix/short-fix-description` или `feature/short-feature-description` Просмотрите [Руководство](https://github.com/FreeCodeCamp/FreeCodeCamp/blob/staging/CONTRIBUTING.md) по [взносам](https://github.com/FreeCodeCamp/FreeCodeCamp/blob/staging/CONTRIBUTING.md) для более подробной информации.
|
||
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 вызван проблемой, вы можете автоматически [ссылаться и закрывать эту проблему](https://help.github.com/articles/closing-issues-via-commit-messages/) , добавив ключевое слово, например `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 отклонен
|
||
|
||
Не отчаивайтесь! Вы должны получать надежную обратную связь от модераторов проблемы относительно того, почему она была отклонена и что необходимо. Пожалуйста, продолжайте участвовать. |