Rozpocząłem projekt, który obejmuje co najmniej trzy repozytoria w GitHub.
Jedno z repozytoriów to ogólny zrzut dokumentacji i przykładów, a pozostałe dwa zawierają implementację dwóch programów, które stanowią kręgosłup projektu.
Czy powinienem używać organizacji GitHub do obsługi takiej konfiguracji?
A może powinienem to wszystko zrzucić na własne konto wraz z tuzinem innych, zupełnie niepowiązanych repozytoriów?
Odpowiedzi:
Zacznij od repozytoriów na swoim koncie osobistym. Stamtąd, jeśli / kiedy rzeczy rosną i / lub stają się popularne w społeczności, przenieś je na konto organizacji.
Spójrzmy na niektóre z twoich opcji:
Aby uzyskać więcej informacji na temat funkcji GitHub Organisation, przeczytaj:
Blog GitHub: organizacje wprowadzające
Jeśli kiedykolwiek musiałeś zarządzać wieloma kontami GitHub, chciałeś pulpitu nawigacyjnego dla konkretnej firmy, chciałeś dodać współpracowników tylko do odczytu lub chciałeś dać komuś kontrolę administracyjną nad jednym z twoich repozytoriów, pokochasz Organizacje.
Na podstawie twojego pytania nie mogę powiedzieć, czy organizacja jest dla ciebie odpowiednia (moje wnętrzności mówią mi „nie”) , ale być może spojrzenie na przykłady z prawdziwego świata pomoże ci podjąć decyzję.
Oto kilka przykładów organizacji GitHub, na które uważam interesujące:
https://github.com/gruntjs
To jeden z moich ulubionych przykładów konta organizacji typu open source. Jestem pod wrażeniem konwencji nazewnictwa używanych w repozytoriach (tj. Zasadniczo grunt/jest to główne repozytorium i wszystkie powiązane podstawowe / kod / wtyczki / zadania są w grunt-xxxx/repozytoriach).
https://github.com/github
Prawdopodobnie warto przyjrzeć się własnej organizacji GitHub. konto. Konwencje nazewnictwa stosowane w repozytoriach nie są tak ścisłe jak w przypadku Grunta (IMHO), ale mimo to jest to dobry przykład. Aha, a teraz jest prawdopodobnie dobry moment, aby wskazać kartę „Członkowie” , ponieważ nie dostaje się jej w przypadku kont osobistych lub repozytoriów.
https://github.com/twbs
Twitter Bootstrap. Myślę, że to dobry przykład organizacji. konto z tylko kilkoma repozytoriami (zwróć uwagę na pojedyncze repozytorium z ponad 58 000 gwiazdkami). Zauważ też, że Bootstrap ma pięciu członków (w chwili pisania tego tekstu), ale ci ci są odpowiedzialni za niezwykle popularne repozytorium (w przeciwieństwie do 214 członków organizacji GitHub ).
Kilka bardziej ogólnych przykładów:
https://github.com/yeoman : Narzędzia do budowania.
https://github.com/h5bp : Kocioł HTML5.
https://github.com/nprapps : Przykład branży wiadomości.
Jak już wspomniałeś, możesz tworzyć repozytoria na swoim koncie osobistym i stamtąd.
Czy potrzebujesz współpracowników?
GitHub Help: Współpraca / Jak dodać współpracownika?
Jak widać, dodawanie współpracowników jest dość bezbolesne.
W zależności od pytania ta opcja brzmi tak, jak chcesz.
Możesz utworzyć jedno repozytorium i wykorzystać gałęzie do uporządkowania powiązanych fragmentów kodu.
Nie sądzę, aby większość ludzi zgodziła się, że to najlepszy sposób na uporządkowanie kodu :
Z drugiej strony nic nie wskazuje na to, że nie można organizować powiązanych fragmentów kodu za pomocą gałęzi.
Jedną z moich irytacji związanych z tą techniką jest to, że GUI / interfejs GitHub pokaże ci ten komunikat:
... podczas przeglądania gałęzi innych niż Twoja master(to znaczy, jeśli twoja gałąź jest w przód / w tył w zatwierdzeniach).
Wskazówka: jeśli używasz nowszej wersji Git, możesz pobrać określone gałęzie, używając git clone -b mybranch --single-branch git://sub.domain.com/repo.git:
Związane z:
Czy powinienem używać organizacji GitHub do obsługi takiej konfiguracji? A może powinienem to wszystko zrzucić na własne konto wraz z tuzinem innych, zupełnie niepowiązanych repozytoriów?
Możesz użyć kombinacji wszystkich powyższych. Na przykład:
Skonfiguruj organizację do „… zrzutu ogólnego dokumentacji i przykładów, a pozostałe dwa zawierają implementację dwóch programów, które stanowią kręgosłup projektu”.
Użyj swojego konta osobistego do „... tuzina innych, całkowicie niepowiązanych repozytoriów”
Użyj gałęzi dla stron demonstracyjnych gh-pages, powiązanego kodu i / lub dokumentacji.
Warto również wspomnieć, że do dokumentacji można użyć WIKI repozytorium: