web-dev-qa-db-ja.com

複数のリポジトリにまたがるプロジェクトのGitHub組織?

GitHubに少なくとも3つのリポジトリが関係するプロジェクトを開始しました。

リポジトリの1つは、一般的なドキュメントとサンプルのダンプで、他の2つには、プロジェクトのバックボーンを形成する2つのプログラムの実装が含まれています。

このような構成を処理するには、GitHub組織を使用する必要がありますか?
それとも、それをすべて自分のアカウントにダンプする必要がありますか。他に、完全に関連性のない他の12のリポジトリとともに、

11
jcora

短い答え ...

個人アカウントのリポジトリから始めます。そこから、物事が成長したり、コミュニティで人気が高まったりした場合は、それらを組織のアカウントに移動します。


長い答え...

あなたのオプションのいくつかを見てみましょう:

1.組織:

GitHub組織の機能の詳細については、必ずお読みください。

GitHubブログ:組織の紹介

複数のGitHubアカウントを管理する必要があり、会社固有のダッシュボードが必要な場合、読み取り専用の共同編集者を追加したい場合、またはリポジトリの1つを他の誰かに管理制御を与える必要がある場合は、組織が大好きです。

あなたの質問に基づいて、組織があなたに適しているかどうかはわかりません(私の直感は「いいえ」と私に言っています")ですが、実際の例を見ると、決定を下すのに役立ちます。

ここで、GitHub組織の例をいくつか見ていきます。

  1. https://github.com/gruntjs
    これは、オープンソースの組織アカウントの私のお気に入りの例の1つです。私は主にリポジトリに使用される命名規則に感銘を受けています(つまり、本質的に grunt/ はメインのリポジトリであり、関連するすべてのコア/コントリビューションコード/プラグイン/タスクはgrunt-xxxx/にありますリポジトリ)。

  2. https://github.com/github
    おそらく、GitHub独自のOrgを検討する価値があります。アカウント。リポジトリに使用される命名規則は、Grunt(IMHO)ほど厳密ではありませんが、それでも良い例です。個人アカウントやリポジトリでは取得できないので、 "Members"タブ を指摘するのにまともな時でしょう。

  3. https://github.com/twbs
    Twitterブートストラップ。これはOrgの良い例だと思います。数個のリポジトリのみのアカウント(58,000以上の星を持つ単一のリポジトリに注意してください)。また、Bootstrapには(これを書いている時点では)5人のメンバーがいますが、これら5人はめちゃくちゃ人気のあるリポジトリを担当しています( GitHub組織の214人のメンバーと比較してください)。 )。

    1. https://github.com/Twitter :TwitterのメインGitHubアカウント。

いくつかのより一般的な例:

  1. https://github.com/yeoman :ビルドツール。

  2. https://github.com/h5bp :HTML5ボイラープレート。

  3. https://github.com/nprapps :ニュース業界の例。

2.個人アカウント

すでに述べたように、個人アカウント内にリポジトリを作成してそこから移動することができます。

協力者が必要ですか?

GitHubヘルプ:コラボレーション/コラボレーターを追加するにはどうすればよいですか?

ご覧のとおり、共同編集者を追加するのは非常に簡単です。

あなたの質問に基づいて、このオプションはあなたが望むもののように聞こえます。

3.複数のブランチを持つリポジトリ:

1つのリポジトリを作成し、ブランチを利用して、関連するコードを整理できます。

ほとんどの人は、これがコードを整理するための最良の方法であることに同意するとは思いません

一方で、ブランチを使用してコードの関連ビットを整理できないということは何もありません。

この手法で私が抱えている個人的な不快な点の1つは、GitHubのGUI /インターフェースが次のメッセージを表示することです。

enter image description here

... master以外のブランチを表示している場合(つまり、ブランチがコミットの前後にある場合)。

ヒント:Gitの最新バージョンを使用している場合は、git clone -b mybranch --single-branch git://sub.domain.com/repo.gitを使用して特定のブランチをプルできます。

関連:

4.ハイブリッドアプローチ:

このような構成を処理するには、GitHub組織を使用する必要がありますか?それとも、それをすべて自分のアカウントにダンプし、他の完全に関連のない数十のリポジトリと一緒にすべきですか?

上記のすべてを組み合わせて使用​​できます。例えば:

  1. 「...一般的なドキュメントと例のダンプ用に組織を設定し、他の2つには、プロジェクトのバックボーンを形成する2つのプログラムの実装が含まれています」。

  2. 個人アカウントを使用して、「...ダースの他の、完全に無関係なリポジトリ」

  3. デモページのブランチを使用 gh-pages 、関連コードおよび/またはドキュメント。


ノート):

文書化の目的でリポジトリのWIKIを使用できることにも言及する価値があります。

14
mhulse