Внести свой вклад через Github

Предпосылки

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

Знать, как использовать минимум Git
Иметь учетную запись Github
Иметь форк проекта, в который вы хотите внести свой вклад

Прежде чем вдаваться в подробности, необходимо сделать небольшое замечание по словарному запасу. Вот небольшой глоссарий слов, которые мы постоянно используем с Git/Github:

репозиторий: сокращение от «Репозиторий». Мы используем это слово для обозначения набора файлов с версиями Git.
ветка: это ветка в проекте Git. Ветки позволяют вам создать параллельную версию кода в какой-то момент истории.
master: Обозначает основную ветвь репо.
origin: обозначает удаленное репо. Хостинг на Github, например.
запрос на извлечение: это операция, которая позволяет вам предложить модификацию кода проекта на Github.
fork: это репо, являющееся копией другого репо. Это позволяет вам начать с существующего проекта, чтобы изменить его, улучшить, исправить или сделать с ним что-то еще.
вверх по течению: в случае форка обозначает репозиторий, из которого исходит форк.
выборка: это операция, заключающаяся в локальном извлечении данных с удаленного устройства.
push: это операция, позволяющая отправлять локальные данные на удаленное устройство.

Конфигурация

Вилка

Первое, что нужно сделать, это зайти на Github, чтобы создать форк проекта, в который вы хотите внести свой вклад.

Например, чтобы внести свой вклад в клиент Leek Wars, перейдите сюда: Клиент Leek Wars

Затем просто нажмите кнопку «вилка» в правом верхнем углу.

«Разветвляя» проект, Github создаст новый репозиторий в вашей учетной записи. Это будет копия оригинального проекта.

Затем получите адрес своего репозитория github через URL-адрес или нажав зеленую кнопку «Клонировать или загрузить».

Перейдите в место, где вы хотите разместить локальное репозиторий, и используйте команду: git clone \ Не забудьте заменить "\".

Так. Вы создали форк проекта и получили его локально на своем компьютере. Но есть еще одна вещь, которую нужно сделать, чтобы иметь возможность продолжать использовать его без забот в будущем.

Вверх по течению

Затем вы должны настроить upstream, что позволит вам обновить репозиторий из проекта.

Команда git remote -v позволяет вывести список сконфигурированных удаленных адресов.

источник https://github.com/YOUR_USERNAME/YOUR_FORK.git (выборка) источник https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)

На данный момент вы должны увидеть два адреса, настроенных как origin. Один в fetch, когда вы хотите репатриировать новые функции со своего remote, вашего репозитория, размещенного на Github. А другой — в push, что, наоборот, позволяет отправлять местные новости в удаленное repo.

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

Команда для добавления upstream: git remote add upstream \

Если вы снова запустите команду git remote -v, вы должны увидеть четыре записи. Два для исходного и два для восходящего. Каждый дублируется в fetch и push.

источник https://github.com/YOUR_USERNAME/YOUR_FORK.git (выборка) источник https://github.com/YOUR_USERNAME/YOUR_FORK.git (push) вверх по течению https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (выборка) вверх по течению https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

Вы готовы внести свой вклад прямо сейчас!

Будьте в курсе

(Шаг необязателен, если вы просто форк.)

Скорее всего, проект, в котором вы участвуете, не высечен на камне. Люди, которые заботятся о нем, заставят его развиваться. Другие вклады потенциально будут приняты.

Таким образом, ваше репо может быстро устареть. И это может быть проблемой.

Если изначально файл содержал «А», и вы хотите внести вклад, чтобы изменить это «А» на «Б». А пока, может быть, кто-то еще изменит эту "А" на "С".

И когда вы предложите свою модификацию, будет конфликт. Невозможно изменить «A» на «B», так как «A» больше нет в файле.

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

Не волнуйтесь, теперь, когда вы настроили upstream, это будет проще простого!

Первое, что нужно сделать, это получить новый m