Как прислать изменения в проект с открытым исходным кодом (на примере OsEngine)

Рис. 1: Медленно положи свой код на пол и пни ко мне!

Ты написал новую крутую фичу? Нашел ошибку в существующем коде? Пришло время прислать новый код в общий репозиторий, чтобы все могли воспользоваться плодами твоих трудов (бесплатно).

Первый шаг — на Гитхабе делаем форк проекта (https://github.com/AlexWan/OsEngine). Для этого нажимаем Fork:



И «Create Fork» на следующем экране:


В результате в твоем аккаунте появится копия репозитория проекта. В моем случае — github.com/nikitabuida/OsEngine. Далее будем называть этот репозиторий форком.

Теперь нужно скачать этот форк на локальную машину и внести изменения в проект.



Скачиваем код форка. Показываю на примере командной строки, но это же самое можно сделать при помощи любого удобного клиента Git:




В результате этой команды весь код форка будет скачан в директорию C:\code\OsEngine-FORK.
Скачивание занимает какое-то время:



Теперь вносим наши изменения в код, который скачали. Здесь подробно не буду останавливаться. Можно просто открыть проект в редакторе и исправить или скопировать готовые файлы, если исправления вносились где-то еще.

Показываю на примере исправления проскальзывания в авто-тестах серверов коннекторов.




Внес изменения в 4 файла.

Делаем коммит git commit -am «комментарий» :



И отправляем внесенные изменения в форк:



Теперь на Гитхабе наш форк отображается как на один коммит опережающий основной репозиторий. Нажимаем «Contribute»:


И далее — жмем «open pull request»:





На следующем экране отобразятся все вносимые в основной проект изменения. Жмем «Create pull request»:




И еще раз, такую же кнопку на следующем экране:




Поздравляю! Pull request создан. Теперь остается дождаться пока владелец репозитория включит (или нет) ваши изменения в основной репозиторий.




В любом случае информация о судьбе изменений придет на почту.

Если включены, то вечная слава и уважение сообщества тебе, программист!