Dołącz do trendu w kodowaniu społecznościowym i współtworz repozytoria GitHub

Czy kiedykolwiek znalazłeś pakiet na GitHub, który Ci się podobał, ale chciałeś dodać szybką funkcję, naprawić znaleziony błąd, a może po prostu przyczynić się do całościowego open source? Dołącz do trendu kodowania społecznościowego, podziel się swoimi umiejętnościami i pomóż światu open source. Z tego artykułu dowiesz się wszystkiego o tym, jak wnieść kod do repozytorium w serwisie GitHub lub dowolnej hostowanej usłudze git.

Pobierz konfigurację

W tym artykule założono, że masz już konto GitHub, ale jeśli nie, to szybko zarejestruj się na darmowe konto. Upewnij się też, że już masz git zainstalowany przez uruchomienie następującego polecenia w terminalu:

git - wersja

Jeśli zamiast zobaczyć numer wersji, pojawi się komunikat „polecenie nie znaleziono”, możesz zainstalować git poleceniem:

sudo apt-get -y install git

Rozwidlaj repozytorium

Najpierw musisz wybrać repozytorium, do którego chcesz wnieść swój wkład, i odwiedzić je w swojej przeglądarce internetowej. Jeśli nie masz pewności, które repozytorium wybrać, możesz skorzystać z repozytorium demonstracyjnego znajdującego się pod adresem

https://github.com/mdizak/muo_demo. To jest proste demo i możesz tworzyć dla niego żądania ściągnięcia do celów testowych i edukacyjnych.

Przeglądając repozytorium w przeglądarce internetowej, poszukaj pliku Repozytorium widelców i kliknij go. Spowoduje to rozwidlenie repozytorium na Twoje własne konto GitHub i doprowadzi do niego. Następnie musisz sklonuj nowo rozwidlone repozytorium, więc otwórz terminal na swoim lokalnym komputerze i uruchom:

Jak sklonować repozytorium za pomocą GitHub Desktop

Chcesz uporać się z oprogramowaniem na GitHub? Oto, jak dotrzeć na wschód dzięki usprawnionemu narzędziu GitHub Desktop.

git clone https://github.com/myusername/muo_demo.git
cd muo_demo

Oczywiście upewnij się, że zmienisz powyższy adres URL na adres twojego nowo rozwidlonego repozytorium. Po sklonowaniu dodaj oryginalne repozytorium jako nadrzędne za pomocą polecenia:

git remote add upstream https://github.com/mdizak/muo_demo.git

Upewnij się, że zmieniłeś adres URL w powyższym poleceniu na adres oryginalnego sklonowanego repozytorium. Oznacza to, że git jest repozytorium nadrzędnym, nad którym pracujesz.

Przygotuj lokalne repozytorium

Za każdym razem, zanim zaczniesz pracować nad nowym wkładem, upewnij się, że używasz najnowszej bazy kodu repozytorium nadrzędnego. W katalogu projektu uruchom następujące polecenia w terminalu:

git checkout master
git pull upstream master && git push origin master

Pierwsze polecenie zapewnia, że ​​aktualnie pracujesz w gałęzi głównej, a drugie polecenie synchronizuje repozytorium nadrzędne zarówno z repozytoriami lokalnymi, jak i GitHub. Gwarantuje to, że modyfikujesz najbardziej zaktualizowaną bazę kodu i nie pracujesz z nieaktualnym kodem.

Upewnij się również, czy projekt zawiera plik contrib.md, a jeśli tak, postępuj zgodnie z jego treścią. Czasami projekty mają szczegółowe wytyczne dotyczące przekazywania wkładu, których należy zawsze przestrzegać.

Utwórz nową gałąź

Musisz utworzyć nową gałąź, która będzie zawierała wszystkie modyfikacje dla tego wkładu, która zostanie później włączona do głównego repozytorium GitHub przez opiekunów projektu. Gałąź musi być alfanumeryczna i może mieć dowolną nazwę.

Chociaż nie jest to wymagane, powszechnie uważa się, że przedrostek nazwy oddziału za pomocą poprawka / do szybkich poprawek błędów lub funkcja/ dla dodatkowych funkcji. Wybierz żądaną nazwę gałęzi i uruchom polecenie:

git checkout -b feature / my_cool_feature

Powinieneś zawsze tworzyć oddzielną gałąź dla każdej funkcji / poprawki błędu i nigdy nie dołączać wielu elementów do jednej. Pomaga to w utrzymaniu płynnego przepływu rozwoju, a także pomaga zapewnić, że Twój wkład zostanie zaakceptowany i uwzględniony w projekcie.

Teraz, gdy twoja gałąź została utworzona, idź dalej i wprowadź wszelkie niezbędne modyfikacje, które chcesz, w standardowym przepływie pracy git.

Zatwierdź i utwórz żądanie ściągnięcia

Po zakończeniu pracy nad swoim wkładem, zatwierdź go rozszerzeniem poprawny komunikat o zmianach i wypchnij go do swojego rozwidlonego repozytorium za pomocą poleceń:

git commit --file commit.txt
git push -u origin feature / my_cool_feature

Ostatnim krokiem jest utworzenie żądania ściągnięcia, które ostrzega opiekunów projektu o oczekiwaniu na nowy wkład. Odwiedź rozwidlone repozytorium GitHub w swojej przeglądarce internetowej, a zobaczysz przycisk rozwijany umożliwiający zmianę gałęzi. Przejdź do nowo utworzonego oddziału, a następna strona będzie zawierała łącze umożliwiające utworzenie nowego żądania ściągnięcia.

Po kliknięciu tego łącza zobaczysz stronę, na której zostanie wyświetlona wiadomość o zatwierdzeniu i wszystkie zmiany, które wprowadziłeś w kodzie. Przejrzyj wszystko, aby upewnić się, że jest poprawne, dodaj wszelkie niezbędne dodatkowe komunikaty dla opiekunów i prześlij żądanie ściągnięcia.

Kontynuuj współtworzenie GitHub

Gratulacje, pomyślnie przesłałeś wkład do projektu GitHub!

Twoje żądanie ściągnięcia oczekuje teraz na przegląd i zatwierdzenie przez opiekunów projektu, a otrzymasz powiadomienie e-mailem, czy zostało zatwierdzone, a także z wszelkimi wiadomościami, które mają dla Ciebie. Teraz, gdy nauczyłeś się, jak współtworzyć projekty w GitHub, idź naprzód i pomagaj rozwijać społeczność open source.

Jak dodać więcej pamięci RAM do urządzenia z systemem Android za pomocą karty MicroSD

Jeśli Twój telefon lub tablet z Androidem działa trochę wolno, może wymagać trochę więcej pamięci RAM. Możemy w tym pomóc.

O autorze