Простой способ поучаствовать в разработке на Github: различия между версиями

Материал из GIS-Lab
Перейти к навигации Перейти к поиску
 
Строка 29: Строка 29:
Обратите внимание, что написано на подсказке. Когда вы нажмете на "редактировать" произойдет следующее:
Обратите внимание, что написано на подсказке. Когда вы нажмете на "редактировать" произойдет следующее:


1. В вашей учетной записи создастся копия оригинального репозитория, т.н. форк
#В вашей учетной записи создастся копия оригинального репозитория, т.н. форк
2. Вы перейдете к редактированию этого же файла в вашей копии
#Вы перейдете к редактированию этого же файла в вашей копии


==Шаг 4: сохранение редакции==
==Шаг 4: сохранение редакции==

Текущая версия от 21:39, 4 января 2016

Это еще одна попытка объяснить как участвовать в разработке через Github.

Эту статью можно и нужно редактировать.

Итак, у вас есть некоторые поправки к коду и вы хотите их предложить его автору.

Вопрос: Как это сделать максимально удобным для него образом?

Ответ: Конечно же сделать Pull request (он же PR)!

По шагам:

Шаг 1: создание учетной записи

Если у вас еще нет учётной записи на Github - создайте её. Если есть - залогиньтесь.

Шаг 2: выбор репозитория

Найдите нужный вам репозиторий с кодом, к которому вы хотите предложить изменения. Например вот этот.

Если вы не знаете в каком репозитории код - узнайте, спросив, например у автора. Если его не существует в принципе, следующие шаги вам ни к чему.

Шаг 3: редактирование

Найдите файл к которому вы хотите добавить ваши изменения и нажмите "отредактировать".

Github-collaborate-01.png

Обратите внимание, что написано на подсказке. Когда вы нажмете на "редактировать" произойдет следующее:

  1. В вашей учетной записи создастся копия оригинального репозитория, т.н. форк
  2. Вы перейдете к редактированию этого же файла в вашей копии

Шаг 4: сохранение редакции

Внесите изменения и нажмите Propose file change, не забыв сопроводить ваши изменения объяснениями что к чему.

Github-collaborate-02.png

Эти изменения будут сохранены в вашей копии (форке) оригинального репозитория. Теперь нужно отправить их автору оригинального кода.

Шаг 5:создание pull request-а

Создайте pull request нажав на Create pull request и потом еще раз нажав на Create pull request.

Github-collaborate-03.png

Это всё. Автор оригинального кода будет вам безмерно благодарен, так как это очень удобный для него способ увидеть все изменения и обсудить их, если необходимо.