Chciałbym przyczynić się do pewnego projektu w GitHub . Czy powinienem to rozwidlać ? Rozgałęziać to? Co jest zalecane i jak to zrobić?

Idealnie ty:

1. Rozwidlaj projekt
2. Dokonaj co najmniej jednego dobrze skomentowanego i czystego zatwierdzenia do repozytorium. Możesz utworzyć nowy oddział tutaj, jeśli modyfikujesz więcej niż jedną część lub element.
3. Wykonaj żądanie ściągnięcia w interfejsie internetowym github.

jeśli jest to nowe żądanie funkcji, nie zaczynaj najpierw kodowania. Pamiętaj, aby opublikować problem w celu omówienia nowej funkcji.

Jeśli funkcja jest dobrze omawiana i istnieje +1 lub właściciel projektu ją zatwierdził, przypisz problem do siebie, a następnie wykonaj powyższe kroki.

Niektóre projekty nie będą korzystać z systemu żądania ściągania. Skontaktuj się z autorem lub listą mailową, aby dowiedzieć się, jak najlepiej odzyskać kod z powrotem do projektu.

Aby dodać do odpowiedzi Yanna , po rozwidleniu projektu możesz rozwinąć dowolną gałąź (nową lub oryginalną)

Pamiętaj by:

• dodaj oryginalny projekt jako zdalny (inna forma ' origin', ponieważ originbyłoby to twoje własne repo, wynik rozwidlenia)
• oprzyj swój oddział na gałęzi oryginalnego repozytorium, które chcesz wnieść.
  Ważne jest, aby żądanie ciągnięcia skutkowało połączeniem do przodu.
  Zobacz na przykład:
  • „ Pobierz nowe aktualizacje z oryginalnego repozytorium Github do rozwidlonego repozytorium Github ”.
  • „ Aktualizacja rozwidlonego repozytorium na github ”
  • „ Widelec roboczy Git z aktualizacjami ”

Aby dodać do odpowiedzi Yan i VonC, jest to dobry zasób od samych github: http://help.github.com/forking/

Pamiętaj również, aby spojrzeć na prawy pasek boczny pod nagłówkiem „współpracujący”.

Jest tutaj świetne wideo z Railscast , które przeprowadzi Cię przez ten proces. Zawiera również szereg dobrych wskazówek, takich jak pokazanie, w jaki sposób określić, nad którą gałęzią chcesz pracować, przyczyniając się, używając testów, submodułów itp.

Chociaż ten screencast koncentruje się przede wszystkim na programistach Railsów, większość informacji jest ważna dla udziału w każdym projekcie open source.

Github ma wiele sposobów współpracy przy projekcie. Modelem najczęściej używanym w projekcie jest model żądania ściągania. Rozpocząłem projekt, aby pomóc ludziom składającym pierwsze żądanie ściągnięcia z GitHub. Możesz zrobić praktyczny samouczek, aby zrobić swój pierwszy PR tutaj

Przepływ pracy jest prosty jak

• Rozwidlaj repo w github
• Sklonuj repozytorium do swojego komputera
• Utwórz oddział i wprowadź niezbędne zmiany
• Wrzuć zmiany do swojego widelca na GitHub git push origin branch-name
• Przejdź do swojego widelca na GitHub, aby zobaczyć Compare and pull requestprzycisk
• Kliknij na nią i podaj niezbędne szczegóły

lornajane ma post na blogu, który dobrze wyjaśnia ten proces: http://www.lornajane.net/posts/2010/contributing-to-projects-on-github

Techniczny przepływ pracy

Sugerowałbym następujący przepływ pracy:

1. Rozwidlaj repozytorium (przez interfejs sieciowy GitHub: przycisk „Widelec”)
2. W rozwidlonym repozytorium skopiuj adres URL

3. Klonuj (w linii poleceń)

   git clone <url-from-your-workspace>

4. Wejdź do właśnie utworzonego katalogu i utwórz gałąź

   cd <directory> git checkout -b <branchname>

5. Teraz wprowadź zmiany

6. Możesz utworzyć jeden lub więcej zatwierdzeń po każdej zmianie:

   commit -a

7. Po zakończeniu naciśnij zmiany

   git push origin <branch>

8. W linii poleceń powinieneś zobaczyć adres URL do utworzenia PR . Odwiedź adres URL i kliknij przycisk, aby utworzyć PR.

9. Jeśli nie, odwiedź repozytorium w przeglądarce, a zobaczysz przycisk do utworzenia żądania ściągnięcia

Otóż ​​to.

Zasadniczo rozwidliłeś repozytorium do swojego obszaru roboczego, utworzyłeś nową gałąź i wypchnąłeś tę nową gałąź.

Jeśli później utworzysz więcej PR z tego samego sklonowanego repozytorium, powinieneś zsynchronizować (uzyskać najnowsze zmiany z oryginalnego repozytorium) przed utworzeniem kolejnej gałęzi dla innego PR:

git checkout master
git remote add upstream <url-of-original-repo>
git pull upstream master

Inne uwagi:

• projekt może mieć Wytyczne dotyczące wkładu: poszukaj pliku CONTRIBUTING.rst lub .md
• możesz postępować zgodnie ze wskazówkami dotyczącymi kodowania dla projektu
• możesz najpierw przedstawić swój pomysł jako problem
• możesz zajrzeć do zakładki Pull Requests dla projektu i sprawdzić, czy jest otwarty PR, scalony PR

Te sugestie są tutaj, aby uchronić cię przed trudem umieszczenia pracy w PR, który nie zostanie scalony. Jeśli w projekcie jest aktywność, a PR zostanie scalony, to dobry znak. Jeśli istnieją Wytyczne dotyczące wkładu, zastosuj się do nich.

Zawsze bądź uprzejmy. Pamiętaj, że opiekunowie projektu nie są w żaden sposób zobowiązani do scalenia twojego PR. Czy masz coś cennego do dodania do projektu?