GitHub-Organisationen für ein Projekt, das mehrere Repositorys umfasst?

11

Ich habe ein Projekt gestartet, das mindestens drei Repositorys auf GitHub umfasst.

Eines der Repositorys ist ein allgemeiner Dokumentations- und Beispielspeicherauszug, und die anderen beiden enthalten die Implementierung von zwei Programmen, die das Rückgrat des Projekts bilden.

Sollte ich eine GitHub-Organisation verwenden, um eine solche Konfiguration durchzuführen?
Oder sollte ich einfach alles zusammen mit einem Dutzend anderer, völlig unabhängiger Repositories auf mein eigenes Konto kopieren?

git github organization repository jcora
quelle

Antworten:

14

Kurze Antwort ...

Beginnen Sie mit den Repositorys in Ihrem persönlichen Konto. Wenn von dort aus Dinge wachsen und / oder in der Community populär werden, verschieben Sie sie von dort auf ein Organisationskonto.

Lange Antwort ...

Schauen wir uns einige Ihrer Optionen an:

1. Organisation:

Weitere Informationen zu den Funktionen von GitHub Organization finden Sie unter:

GitHub Blog: Einführung in Organisationen

Wenn Sie jemals mehrere GitHub-Konten verwalten mussten, ein unternehmensspezifisches Dashboard wünschten, schreibgeschützte Mitarbeiter hinzufügen wollten oder jemand anderem die administrative Kontrolle über eines Ihrer Repositorys geben mussten, werden Sie Organisationen lieben.

Aufgrund Ihrer Frage kann ich nicht sagen, ob eine Organisation für Sie geeignet ist (mein Bauch sagt mir "Nein") , aber vielleicht hilft Ihnen das Betrachten einiger Beispiele aus der Praxis bei Ihrer Entscheidung.

Hier sind einige Beispiele für GitHub-Organisationen, die ich interessant finde:

  1. https://github.com/gruntjs
    Dies ist eines meiner Lieblingsbeispiele für ein Open Source-Organisationskonto. Ich bin am meisten beeindruckt von den Namenskonventionen, die für Repositorys verwendet werden (dh im Wesentlichen grunt/ist das Haupt-Repo und alle zugehörigen Kern- / Contrib-Codes / Plugins / Aufgaben befinden sich in grunt-xxxx/Repositorys).

  2. https://github.com/github
    Wahrscheinlich lohnt es sich, sich GitHubs eigene Org anzusehen. Konto. Die für die Repositorys verwendeten Namenskonventionen sind nicht so streng wie die von Grunt (IMHO), aber dennoch ein gutes Beispiel. Oh, und jetzt ist wahrscheinlich ein guter Zeitpunkt, um auf die Registerkarte "Mitglieder" hinzuweisen , da Sie dies nicht für persönliche Konten oder Repositories erhalten.

  3. https://github.com/twbs
    Twitter Bootstrap. Ich denke, das ist ein gutes Beispiel für eine Org. Konto mit nur wenigen Repositories (beachten Sie das einzelne Repo mit mehr als 58.000 Sternen). Beachten Sie auch, dass Bootstrap fünf Mitglieder hat (zum Zeitpunkt des Schreibens dieses Dokuments), diese fünf jedoch für ein wahnsinnig beliebtes Repository verantwortlich sind (im Gegensatz zu den 214 Mitgliedern der GitHub-Organisation ).

    1. https://github.com/twitter : Twitter's Haupt-GitHub-Account.

Einige allgemeinere Beispiele:

  1. https://github.com/yeoman : Tools erstellen.

  2. https://github.com/h5bp : HTML5-Boilerplate.

  3. https://github.com/nprapps : Beispiel für die Nachrichtenbranche.

2. Persönliches Konto

Wie Sie bereits erwähnt haben, können Sie Repositorys in Ihrem persönlichen Konto erstellen und von dort aus fortfahren.

Benötigen Sie Mitarbeiter?

GitHub-Hilfe: Zusammenarbeit / Wie füge ich einen Mitarbeiter hinzu?

Wie Sie sehen können, ist das Hinzufügen von Mitarbeitern ziemlich schmerzlos.

Basierend auf Ihrer Frage klingt diese Option wie die gewünschte.

3. Repo mit mehreren Zweigen:

Sie können ein Repository erstellen und Zweige verwenden, um die zugehörigen Codebits zu organisieren.

Ich glaube nicht, dass die meisten Leute zustimmen würden, dass dies der beste Weg ist, Ihren Code zu organisieren :

Auf der anderen Seite gibt es nichts, was besagt, dass Sie verwandte Codebits nicht mithilfe von Verzweigungen organisieren können.

Ein persönlicher Ärger, den ich mit dieser Technik habe, ist, dass die Benutzeroberfläche / Benutzeroberfläche von GitHub Ihnen diese Meldung anzeigt:

Geben Sie hier die Bildbeschreibung ein

... wenn Sie andere Zweige als Ihren anzeigen master(dh wenn Ihr Zweig bei Commits vor / hinter sich liegt).

Tipp: Wenn Sie eine neuere Version von Git verwenden, können Sie bestimmte Zweige abrufen, indem Sie git clone -b mybranch --single-branch git://sub.domain.com/repo.git:

Verbunden:

4. Hybrider Ansatz:

Sollte ich eine GitHub-Organisation verwenden, um eine solche Konfiguration durchzuführen? Oder sollte ich einfach alles zusammen mit einem Dutzend anderer, völlig unabhängiger Repositories auf mein eigenes Konto kopieren?

Sie können eine Kombination aus allen oben genannten verwenden. Beispielsweise:

  1. Richten Sie eine Organisation für "... generischen Dokumentations- und Beispielspeicherauszug ein, und die anderen beiden enthalten die Implementierung von zwei Programmen, die das Rückgrat des Projekts bilden".

  2. Verwenden Sie Ihr persönliches Konto für "... ein Dutzend andere, völlig unabhängige Repositories".

  3. Verwenden Sie Zweige für Demoseiten gh-pages, zugehörigen Code und / oder Dokumentation.

Anmerkungen):

Erwähnenswert ist auch, dass Sie das WIKI eines Repositorys zu Dokumentationszwecken verwenden können:

mhulse
quelle