GitHubのプロジェクトとリポジトリ

GitHubで、プロジェクト（リポジトリ内に作成できる）とリポジトリの概念的な違いは何ですか？

SOでいくつかの同様の質問（ここ、ここ、ここ）を見たことがありますが、どれもG​​itHubプロジェクトとは何か、GitHubリポジトリとは何か、およびそれぞれをいつ使用するかについて説明していません。

誰かが各用語を説明し、それぞれの用語をいつ使用/作成するかの例を提供していただければ幸いです。たとえば、すべて独立した複数のプロトタイプアプリケーションがある場合、それらすべてのソースコードを体系的に管理するために何を作成すればよいですか？

GitHubは最近Projectsと呼ばれる新機能を導入しました。これにより、多くのプロジェクト管理ツールに典型的な視覚的なボードが提供されます。

リポジトリ GitHubの上で文書化されているように：

リポジトリは、GitHubの最も基本的な要素です。プロジェクトのフォルダとして想像するのが最も簡単です。リポジトリには、すべてのプロジェクトファイル（ドキュメントを含む）が含まれ、各ファイルの変更履歴が保存されます。リポジトリは複数の共同作業者を持つことができ、パブリックまたはプライベートのいずれかにすることができます。

A プロジェクト GitHubの上で文書化されているように：

GitHubのプロジェクトボードは、作業の整理と優先順位付けに役立ちます。特定の機能作業、包括的なロードマップ、またはリリースチェックリストのプロジェクトボードを作成できます。プロジェクトボードを使用すると、ニーズに合ったカスタマイズされたワークフローを柔軟に作成できます。

混乱の一部は、新機能であるプロジェクトが、上記のドキュメントでのプロジェクトという用語の過負荷使用と競合することです。

事実1：プロジェクトとリポジトリは常にGitHubの同義語でした。

事実2：これはもう当てはまりません。

リポジトリとプロジェクトについては多くの混乱があります。以前は、両方の用語がユーザーとGitHubの独自のドキュメントでほとんど同じ意味で使用されていました。これは、これらの用語間の微妙な違いと、一方が他方よりも好まれる時期を説明するここでの回答とコメントの一部に反映されています。違いは常に微妙でした。たとえば、課題追跡がプロジェクトの一部であるが、厳密にはgitのものと考えられるリポジトリの一部ではないなど。

もう違います。

現在、リポジトリとプロジェクトは、別々のAPIを持つさまざまな種類のエンティティを参照しています。

• https://developer.github.com/v3/repos/
• https://developer.github.com/v3/projects/

それ以来、レポをプロジェクトと呼ぶこと、またはその逆を行うことはもはや正しくありません。公式ドキュメントではしばしば混乱していることに注意してください。すでに広く使用されている用語が新しいエンティティの名前として選択されているのは残念ですが、これは事実です。

その結果、リポジトリとプロジェクトは通常混乱し、GitHubプロジェクトについて読むたびに、それが本当にプロジェクトに関するものなのか、それともリポジトリに関するものなのか疑問に思う必要があります。彼らが他の名前または「proj」のような略語を選択した場合、説明されているのは、新しいタイプのエンティティ、具体的なプロパティを持つ正確なオブジェクト、または一般的に言えばレポのようなプロジェクトのようなものです。

通常、明確な用語は「プロジェクトボード」です。

APIから何を学ぶことができるか

Projects APIのドキュメントの最初のエンドポイント：

• https://developer.github.com/v3/projects/#list-repository-projects

の説明は次のとおりです。つまり、リポジトリは多くのプロジェクトを持つことができます。したがって、これら2つが同じことを意味することはできません。プロジェクトが無効になっている場合の応答が含まれます。

{
  "message": "Projects are disabled for this repo",
  "documentation_url": "https://developer.github.com/v3"
}

つまり、一部のリポジトリはプロジェクトを無効にすることができます。繰り返しになりますが、リポジトリがプロジェクトを無効にできる場合、これらは同じことではありません。

他にも興味深いエンドポイントがいくつかあります。

• リポジトリプロジェクトを作成する -POST /repos/:owner/:repo/projects
• 組織プロジェクトを作成する -POST /orgs/:org/projects

しかしありません：

• ユーザーのプロジェクトを作成 -POST /users/:user/projects

これにより、別の違いが生じます。

1.リポジトリはユーザーまたは組織に属することができます
2.プロジェクトはリポジトリまたは組織に属することができます

または、より重要なこと：

1.プロジェクトはリポジトリに所属できますが、その逆はできません
2.プロジェクトは組織に所属
できますが、ユーザーには所属できません3.リポジトリは組織とユーザーに所属できます

以下も参照してください。

• https://help.github.com/articles/about-project-boards/

私はそれが混乱していることを知っています。私はそれをできるだけ正確に説明しようとしました。

GitHubリポジトリは、気になるすべてのファイル、フォルダ、その他のリソースを保存するために使用されます。

Gitプロジェクト：Gitリポジトリのリソースの1つでもあり、主な用途はビジュアルボードでプロジェクトを管理することです。Gitリポジトリでプロジェクトを作成すると、プロジェクトを管理するためのカンバンボードのようなビジュアルボードが作成されます。

このようにして、リポジトリに複数のプロジェクトを含めることができます。

一般に、GitHubでは、1つのリポジトリ= 1つのプロジェクトです。例：https : //github.com/spring-projects/spring-boot。しかし、それは難しいルールではありません。

1つのリポジトリ=多くのプロジェクト。例：https : //github.com/donhuvy/java_examples

1プロジェクト=多くのリポジトリ。たとえば：https://github.com/zendframework/zendframework（Zend Frameworkの3という名前の1つのプロジェクトは、61 + 1 = 62リポジトリを持っている、とは思わないメインリポジトリ+ Zendのフレームワークモジュールを数えるようにしますか？）

@Brandon Ibbotsonのコメントに完全に同意します。

GitHubリポジトリは、フォルダとファイルが存在できる「ディレクトリ」にすぎません。

git語彙に関して、プロジェクトは実際のコンテンツ（ファイル）が存在するフォルダーです。一方、リポジトリ（レポ）は、gitがプロジェクトフォルダーで行われたすべての変更の記録を保持するフォルダーです。しかし、一般的な意味では、これら2つは同じであると考えることができます。 プロジェクト=リポジトリ

私の理解における概念的な違いは、プロジェクトには多くのレポが含まれる可能性があり、互いに独立している一方で、同時にレポは多くのプロジェクトを含む可能性があるということです。Repoは単なるコードの保管場所であり、プロジェクトは特定の機能のタスクのコレクションです。

それは理にかなっていますか？大規模なリポジトリでは、さまざまな人が同時に多くのプロジェクトに取り組んでいる可能性があります（モノリスに追加されるさまざまな機能がたくさんあります）。その他-マイクロサービス？それはあなたが何をしたいかについての個人的な見解です。私はリポジトリ（ストレージ）とプロジェクト（タスク）の主な違いだと思います-私が間違っている場合は、私に知らせてください/説明してください！ありがとう。

これは、このトピックに関する私の個人的な理解です。

プロジェクトの場合、さまざまなリポジトリーでバージョン管理を行うことができます。また、リポジトリの場合、プロジェクト全体またはプロジェクトの一部を管理できます。

プロジェクトについて（それぞれに依存しないいくつかのプロトタイプアプリケーション）。1つのリポジトリまたは複数のリポジトリでプロジェクトを管理できますが、違いは次のとおりです。

1. 1つのリポジトリで管理します。アプリケーションの1つが変更されると、プロジェクト全体（すべてのアプリケーション）が新しいバージョンにコミットされます。

2. 複数のリポジトリで管理します。1つのアプリケーションが変更された場合、そのアプリケーションを管理するリポジトリにのみ影響します。他のリポジトリのバージョンは変更されていません。