Dự án vs Kho lưu trữ trong GitHub

Trong GitHub, sự khác biệt về khái niệm giữa một dự án (có thể được tạo bên trong một kho lưu trữ) và một kho lưu trữ là gì?

Tôi đã thấy một số câu hỏi tương tự ( ở đây , ở đây và ở đây ) trong SO, nhưng không có câu hỏi nào giải thích dự án GitHub là gì, kho lưu trữ GitHub là gì và khi nào nên sử dụng từng câu hỏi.

Tôi sẽ đánh giá cao nếu ai đó có thể giải thích từng thuật ngữ và cung cấp một ví dụ về thời điểm sử dụng / tạo từng thuật ngữ. Chẳng hạn, nếu tôi có một vài ứng dụng nguyên mẫu, tất cả đều độc lập với nhau, tôi phải tạo gì để quản lý một cách có tổ chức mã nguồn cho tất cả chúng?

GitHub gần đây đã giới thiệu một tính năng mới gọi là Dự án . Điều này cung cấp một bảng trực quan điển hình cho nhiều công cụ Quản lý dự án:

Một kho lưu trữ như tài liệu trên GitHub:

Kho lưu trữ là thành phần cơ bản nhất của GitHub. Chúng dễ hình dung nhất như một thư mục của dự án. Kho lưu trữ chứa tất cả các tệp dự án (bao gồm tài liệu) và lưu trữ lịch sử sửa đổi của mỗi tệp. Các kho lưu trữ có thể có nhiều cộng tác viên và có thể là công khai hoặc riêng tư.

Một dự án như được ghi lại trên GitHub:

Bảng dự án trên GitHub giúp bạn tổ chức và ưu tiên công việc của bạn. Bạn có thể tạo bảng dự án cho công việc tính năng cụ thể, lộ trình toàn diện hoặc thậm chí phát hành danh sách kiểm tra. Với bảng dự án, bạn có thể linh hoạt để tạo ra các quy trình công việc tùy chỉnh phù hợp với nhu cầu của bạn.

Một phần của sự nhầm lẫn là tính năng mới, Dự án, mâu thuẫn với việc sử dụng quá tải của thuật ngữ dự án trong tài liệu trên.

Sự thật 1: Các dự án và kho lưu trữ luôn là từ đồng nghĩa trên GitHub.

Sự thật 2: Đây không còn là trường hợp nữa.

Có rất nhiều nhầm lẫn về Kho và Dự án. Trước đây, cả hai thuật ngữ đều được sử dụng thay thế cho nhau bởi người dùng và tài liệu rất riêng của GitHub. Điều này được phản ánh bởi một số câu trả lời và nhận xét ở đây giải thích sự khác biệt tinh tế giữa các điều khoản đó và khi điều khoản này được ưa thích hơn các điều khoản khác. Sự khác biệt luôn luôn tinh tế, ví dụ như trình theo dõi vấn đề là một phần của dự án nhưng không phải là một phần của kho lưu trữ có thể được coi là một điều nghiêm ngặt, v.v.

Không còn nữa.

Các repos và dự án hiện tại đề cập đến một loại thực thể khác nhau có API riêng biệt :

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

Kể từ đó, không còn đúng khi gọi repo là một dự án hoặc ngược lại. Lưu ý rằng nó thường bị nhầm lẫn trong tài liệu chính thức và thật không may là một thuật ngữ đã được sử dụng rộng rãi đã được chọn làm tên của thực thể mới nhưng đây là trường hợp và chúng ta phải sống với điều đó.

Hậu quả là các repos và dự án thường bị nhầm lẫn và mỗi khi bạn đọc về các dự án GitHub, bạn phải tự hỏi liệu đó có thực sự là về các dự án hay về repos không. Nếu họ đã chọn một số tên khác hoặc một từ viết tắt như "proj" thì chúng ta có thể biết rằng những gì được thảo luận là loại thực thể mới, một đối tượng chính xác với các thuộc tính cụ thể hoặc một loại dự án nói chung giống như repo.

Thuật ngữ thường không rõ ràng là "bảng dự án" .

Chúng ta có thể học được gì từ API

Điểm cuối đầu tiên trong tài liệu của API dự án:

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

được mô tả là: Liệt kê các dự án kho lưu trữ . Nó có nghĩa là một kho lưu trữ có thể có nhiều dự án. Vì vậy, hai cái đó không thể có nghĩa giống nhau. Nó bao gồm Phản hồi nếu dự án bị vô hiệu hóa :

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

có nghĩa là một số repos có thể có các dự án bị vô hiệu hóa. Một lần nữa, những điều đó không thể là điều tương tự khi một repo có thể vô hiệu hóa các dự án.

Có một số điểm cuối thú vị khác:

• Tạo một dự án kho lưu trữ -POST /repos/:owner/:repo/projects
• Tạo một dự án tổ chức -POST /orgs/:org/projects

nhưng không có :

• Tạo một dự án của người dùng -POST /users/:user/projects

Điều này dẫn chúng ta đến một sự khác biệt khác:

1. Kho lưu trữ có thể thuộc về người dùng hoặc tổ chức
2. Dự án có thể thuộc về kho hoặc tổ chức

hoặc, quan trọng hơn:

1. Dự án có thể thuộc về kho nhưng không phải theo cách khác
2. Dự án có thể thuộc về tổ chức nhưng không
thuộc về người dùng 3. Kho có thể thuộc về tổ chức và người dùng

Xem thêm:

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

Tôi biết nó khó hiểu. Tôi đã cố gắng giải thích nó chính xác nhất có thể.

Kho GitHub được sử dụng để lưu trữ tất cả các tệp, thư mục và các tài nguyên khác mà bạn quan tâm.

Dự án Git: Đây cũng là một trong những Tài nguyên trong Kho lưu trữ Git và công dụng chính của nó là quản lý các dự án bằng một bảng trực quan. Nếu bạn tạo một dự án trong Kho lưu trữ Git, nó sẽ tạo một bảng trực quan giống như bảng Kanban để quản lý dự án.

Theo cách này, bạn có thể có nhiều dự án trong một kho lưu trữ.

Nói chung, trên GitHub, 1 repository = 1 dự án . Ví dụ: https://github.com/spring-projects/spring-boot . Nhưng đó không phải là một quy tắc khó khăn.

1 kho = nhiều dự án . Ví dụ: https://github.com/donhuvy/java_examples

1 dự án = nhiều kho lưu trữ . Ví dụ: https://github.com/zendframework/zendframework (1 dự án có tên Zend Framework 3 có 61 + 1 = 62 kho lưu trữ, đừng tin? Hãy đếm mô-đun + kho lưu trữ chính của Zend Frameworks)

Tôi hoàn toàn đồng ý với nhận xét của @Brandon Ibbotson :

Kho lưu trữ GitHub chỉ là một "thư mục" nơi các thư mục và tệp có thể tồn tại.

Đối với từ vựng git, Project là thư mục chứa nội dung (tệp) thực tế. Trong khi đó Kho lưu trữ (repo) là thư mục bên trong git giữ bản ghi của mọi thay đổi được thực hiện trong thư mục dự án . Nhưng theo một nghĩa chung, hai cái này có thể được coi là giống nhau. Dự án = Kho lưu trữ

Sự khác biệt về khái niệm theo tôi hiểu rằng một dự án có thể chứa nhiều repo và độc lập với nhau, trong khi đồng thời một repo có thể chứa nhiều dự án. Repo chỉ là nơi lưu trữ mã trong khi dự án là tập hợp các tác vụ cho một tính năng nhất định.

Điều đó có ý nghĩa? Một repo lớn có thể có nhiều dự án được thực hiện bởi nhiều người khác nhau cùng một lúc (rất nhiều tính năng khác nhau được thêm vào một khối), một dự án lớn có thể có nhiều repos nhỏ riêng biệt nhưng là một phần của cùng một dự án tương tác với nhau khác - microservice? Đó là một cá nhân về những gì bạn muốn làm. Tôi nghĩ rằng repo (lưu trữ) so với dự án (nhiệm vụ) là sự khác biệt chính - nếu tôi sai xin vui lòng cho tôi biết / giải thích! Cảm ơn.

Đây là sự hiểu biết cá nhân của tôi về chủ đề này.

Đối với một dự án, chúng ta có thể thực hiện kiểm soát phiên bản bằng các kho khác nhau. Và đối với một kho lưu trữ, nó có thể quản lý toàn bộ dự án hoặc một phần của dự án.

Về dự án của bạn (một số ứng dụng nguyên mẫu độc lập với từng dự án). Bạn có thể quản lý dự án bằng một kho lưu trữ hoặc một số kho lưu trữ, sự khác biệt:

1. Quản lý bởi một kho lưu trữ. Nếu một trong các ứng dụng bị thay đổi, toàn bộ dự án (tất cả các ứng dụng) sẽ được cam kết cho một phiên bản mới.

2. Quản lý bởi một số kho lưu trữ. Nếu một ứng dụng bị thay đổi, nó sẽ chỉ ảnh hưởng đến kho lưu trữ quản lý ứng dụng. Phiên bản cho các kho khác không được thay đổi.