Как да направите първата си заявка за изтегляне на GitHub

Какво е разклонението?

Когато обичаме нечие хранилище и бихме искали да го имаме в нашия акаунт в GitHub, ние го разклоняваме, за да можем да работим отделно с него.

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

Какво е искане за изтегляне?

Исканията за изтегляне са начинът, по който допринасяме за групови проекти или проекти с отворен код.

Например потребител Хари форкира хранилище на ThanoshanMV и прави промени в него. Сега Хари може да направи заявка за изтегляне до ThanoshanMV, но зависи от ThanoshanMV да я приеме или отхвърли. Това е все едно да кажете: „ThanoshanMV, бихте ли помолили за моите промени?“

Какво означава да допринесеш

Не само можем да допринесем за проект с отворен код с код, но можем да допринесем и по много други начини. Някои от тези начини са описани по-долу.

Както се казва в ръководството за начало на хаотичност на ИТ на 99xtechnology, ние можем да допринесем за проект с отворен код по следните начини:

  1. Проектиране: Можете да създадете оформления на даден проект, за да подобрите неговата използваемост, да подобрите навигацията и менюто на проекта въз основа на потребителски изследователски програми, да създадете изкуство за лога или тениски и да предоставите ръководства за стил за проекта.
  2. Писане: Можете да напишете и подобрите документацията на проекта или да преведете документацията, да стартирате бюлетин за проекта или да напишете уроци за проекта и да подготвите акценти от пощенския списък или да подготвите папка с примери, показващи как се използват проектите.
  3. Организиране: Можете да свързвате дублирани издания, да предлагате нови етикети на издания, да предлагате да затворите стари отворени въпроси и да задавате въпроси по наскоро отворени въпроси, за да придвижите дискусията напред.
  4. Помогнете на другите: Отговорете на въпроси по отворени въпроси, прегледайте кода на мненията на други хора и предложите да бъдете ментор на друг сътрудник.
  5. Кодиране: Помогнете за решаването на всички отворени проблеми, попитайте дали можете да предоставите някакви нови функции и да подобрите инструментариума и тестването.

Нека направим първата си заявка за изтегляне!

Ако не сте много запознати с Git & GitHub, моля, прегледайте Ръководството за начинаещи за Git & GitHub.

1. Разклонете хранилището

Разклонете хранилището, като щракнете върху бутона за разклонение в горната част на страницата. Това ще създаде екземпляр на цялото това хранилище във вашия акаунт.

2. Клонирайте хранилището

След като хранилището е във вашия акаунт, клонирайте го на вашата машина, за да работите с него локално.

За да клонирате, щракнете върху бутона за клониране и копирайте връзката.

Отворете терминала и изпълнете следната команда. Той ще клонира хранилището локално.

$ git clone [HTTPS ADDRESS]

Сега сме създали копие на главния клон от основното хранилище на онлайн проекти.

Трябва да отидем до тази клонирана директория, като изпълним тази команда:

$ cd [NAME OF REPOSITORY]

3. Създайте клон

Добра практика е да създавате нов клон при работа с хранилища, независимо дали е малък проект или допринасяте за работата на група.

Името на клона трябва да е кратко и да отразява работата, която вършим.

Сега създайте клон с помощта на git checkoutкомандата:

$ git checkout -b [Branch Name]

4. Правете промени и ги ангажирайте

Направете съществени промени в проекта и го запазете.

След това изпълнете git statusи ще видите промените.

Добавете тези промени към току-що създадения клон с помощта на git addкомандата:

$ git add .

Сега извършете тези промени, като използвате git commitкомандата:

$ git commit -m "Adding an article to week 02 of articles of the week"

5. Натиснете промените в GitHub

За да прокараме промените в GitHub, трябва да идентифицираме името на дистанционното.

$ git remote

За това хранилище името на дистанционното е „origin“.

След като идентифицираме името на дистанционното, можем безопасно да изпратим тези промени към GitHub.

git push origin [Branch Name]

6. Създайте заявка за изтегляне

Отидете в хранилището си на GitHub и ще видите бутон „Сравнение и издърпване на заявка“ и щракнете върху него.

Моля, предоставете необходимите подробности за това, което сте направили (Можете да се позовете на проблеми, като използвате „#“). Сега подайте заявката за изтегляне.

Честито! Направихте първата си заявка за изтегляне.  

Ако вашата заявка за изтегляне бъде приета, ще получите имейл.

7. Синхронизирайте разклонения главен клон

Преди да изпратите заявки за изтегляне в оригиналното хранилище, трябва да синхронизирате хранилището си с оригиналното хранилище.

Дори ако няма да изпращате заявка за изтегляне до оригиналното хранилище, по-добре е да синхронизирате с оригиналното хранилище, тъй като някои допълнителни функции и корекции на грешки може да са направени, откакто сте разделили оригиналното хранилище.

Следвайте тези стъпки, за да актуализирате / синхронизирате тези промени в главния клон:

  1. Първо проверете в кой клон се намирате.
$ git branch

Той ще изброи всички клонове и показва текущия или активния клон в зелено.

2. Превключете към главния клон.

$ git checkout master

3. Добавете оригиналното хранилище като хранилище нагоре по веригата.

За да изтеглите промените от оригиналното хранилище във вашата раздвоена версия, трябва да добавите оригиналното хранилище на Git като хранилище нагоре по веригата.

$ git remote add upstream [HTTPS]

Тук [HTTPS] е URL адресът, който трябва да копирате от хранилището на собственика.

4. Вземете хранилището.

Вземете всички промени от оригиналното хранилище. Ангажиментите към оригиналното хранилище ще се съхраняват в локален клон, наречен upstream / master.

$ git fetch upstream

5. Обединете го.

Обединете промените от upstream / master във вашия локален master клон. Това ще синхронизира главния клон на вашата вилица с хранилището нагоре по веригата, без да губи локалните ви промени.

$ git merge upstream/master

6. Натиснете промените в GitHub

В този момент вашият локален клон се синхронизира с главния клон на оригиналното хранилище. Ако искате да актуализирате хранилището на GitHub, трябва да натиснете промените.

$ git push origin master

ЗАБЕЛЕЖКА: След като синхронизирате разклонения главен клон, можете да премахнете дистанционното, ако искате. Но ще трябва да актуализирате / синхронизирате хранилището си и в бъдеще, така че е най-добрата практика да го запазите.

$ git remote rm [Remote Name]

8. Изтрийте ненужния клон

Клоновете се създават със специална цел. След като тази цел бъде постигната, тези клонове не са необходими, така че можете да ги изтриете.

$ git branch -d [Branch Name]

Можете да изтриете и неговата версия на GitHub.

git push origin --delete [Branch Name]

Заключение

GitHub е мощен инструмент за контрол на историята на версиите. Всеки може да допринесе за проекти с отворен код, като отправя заявки за изтегляне. Приносът не винаги е код - има и други начини за принос.

И накрая, трябва да ви кажа, че не трябва да се притеснявате, ако вашите заявки за изтегляне бъдат отхвърлени. Поддръжниците отделят много време за подобряване на проектите си и знаят много повече за проектите си от нас. Така че не се притеснявайте, ако вашата заявка не е обединена.

Останете силни, останете позитивни и никога не се отказвайте.

- Рой Т. Бенет, Светлината в сърцето

Тази статия първоначално е публикувана в Medium.

Можете да се свържете и да се свържете с мен в Twitter.

Продължавайте да допринасяте за света с отворен код!