GitHub'da Proje ve Depo

GitHub'da, bir proje (bir havuz içinde oluşturulabilir) ile bir havuz arasındaki kavramsal fark nedir?

SO'da birkaç benzer soru gördüm ( burada , burada ve burada ), ancak hiçbiri GitHub projesinin ne olduğunu, GitHub havuzunun ne olduğunu ve her birinin ne zaman kullanılacağını açıklamıyor.

Birinin her terimi açıklayıp açıklayamayacağını ve her birini ne zaman kullanacağını / yaratacağına dair bir örnek verebilir miyim. Örneğin, birbirinden bağımsız birkaç prototip uygulamam varsa, kaynak kodlarının tümünü organize bir şekilde yönetmek için ne yaratırım?

GitHub kısa süre önce Projeler adlı yeni bir özellik sundu . Bu, birçok Proje Yönetimi aracının tipik bir görsel panosunu sağlar:

GitHub'da belgelendiği gibi bir Havuz :

Havuz, GitHub'ın en temel öğesidir. Bir proje klasörü olarak hayal etmek en kolay olanıdır. Bir havuz tüm proje dosyalarını içerir (belgeler dahil) ve her dosyanın düzeltme geçmişini saklar. Depolarda birden çok ortak çalışan olabilir ve ortak veya özel olabilir.

GitHub'da belgelendiği gibi bir Proje :

GitHub'daki proje panoları çalışmanızı organize etmenize ve önceliklendirmenize yardımcı olur. Belirli özellik çalışmaları, kapsamlı yol haritaları ve hatta kontrol listelerini yayınlamak için proje panoları oluşturabilirsiniz. Proje panoları ile, ihtiyaçlarınıza uygun özelleştirilmiş iş akışları oluşturma esnekliğine sahip olursunuz.

Karışıklıkların bir kısmı, yeni özellik olan Projeler'in, yukarıdaki belgede proje döneminin aşırı kullanımı ile çakışmasıdır .

Gerçek 1: Projeler ve Depolar GitHub'da her zaman eşanlamlıydı.

Gerçek 2: Artık böyle değil.

Depolar ve Projeler hakkında çok fazla kafa karışıklığı var. Geçmişte her iki terim de kullanıcılar ve GitHub'ın kendi belgeleri tarafından hemen hemen birbirinin yerine kullanılıyordu. Bu, bu terimler arasındaki ve birinin diğerine göre ne zaman tercih edildiğini açıklayan bazı cevaplar ve yorumlarla yansıtılmaktadır. Aradaki fark izleyicinin projenin bir parçası olması, ancak kesinlikle gitmiş bir şey olarak düşünülebilecek deponun bir parçası olmaması gibi fark her zaman inceydi.

Artık değil.

Şu anda depolar ve projeler , ayrı API'lara sahip farklı türde varlıkları ifade eder :

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

O zamandan beri repoya bir proje demek ya da tam tersi doğru değil. Resmi belgelerde sıklıkla karıştırıldığını ve zaten yaygın olarak kullanılan bir terimin yeni varlığın adı olarak seçilmesinin talihsiz olduğunu unutmayın, ancak durum budur ve bununla yaşamak zorundayız.

Sonuç olarak, depoların ve projelerin genellikle kafası karışır ve GitHub projeleri hakkında her okuduğunuzda bunun gerçekten projeler veya depolarla ilgili olup olmadığını merak etmeniz gerekir. Başka bir isim veya "proj" gibi bir kısaltma seçtilerse, tartışılan şeyin yeni tür varlık, somut özelliklere sahip kesin bir nesne veya genel olarak konuşan repo benzeri mermi türü bir şey olduğunu bilebilirdik.

Genellikle açık olan terim "proje tahtası" dır .

API'dan ne öğrenebiliriz

Projeler API'sının dokümantasyonundaki ilk uç nokta:

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

şu şekilde tanımlanır: Havuz projelerini listeleyin . Bir havuzun birçok projeye sahip olabileceği anlamına gelir. Yani bu ikisi aynı anlama gelemez. Projeler devre dışı bırakılmışsa Yanıt içerir :

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

bu da bazı depoların projeleri devre dışı bırakabileceği anlamına gelir. Yine, bir repoda projeler devre dışı bırakılabilirse bunlar aynı şey olamaz.

Başka ilginç son noktalar da var:

• Havuz projesi oluşturma -POST /repos/:owner/:repo/projects
• Bir organizasyon projesi oluşturun -POST /orgs/:org/projects

ama yok :

• Bir kullanıcının projesi oluşturun -POST /users/:user/projects

Bu bizi başka bir farka götürür:

1. Depolar kullanıcılara veya kuruluşlara
ait olabilir 2. Projeler depolara veya kuruluşlara ait olabilir

veya daha da önemlisi:

1. Projeler depolara ait olabilir, ancak tam
tersi olamaz 2. Projeler kuruluşlara ait olabilir ancak kullanıcılara
ait olmayabilir 3. Depolar kuruluşlara ve kullanıcılara ait olabilir

Ayrıca bakınız:

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

Kafa karıştırıcı olduğunu biliyorum. Bunu olabildiğince açıklamaya çalıştım.

GitHub Depoları, önem verdiğiniz tüm dosyaları, klasörleri ve diğer kaynakları saklamak için kullanılır.

Git Projesi: Ayrıca Git Deposu'ndaki Kaynaklardan biridir ve ana kullanımı projeleri görsel bir tahta ile yönetmektir. Git Deposunda bir proje oluşturursanız, projeyi yönetmek için Kanban panosu gibi bir görsel pano oluşturur.

Bu şekilde, bir depoda birden fazla projeniz olabilir.

Genel olarak GitHub'da 1 havuz = 1 proje . Örneğin: https://github.com/spring-projects/spring-boot . Ama bu zor bir kural değil.

1 depo = birçok proje . Örneğin: https://github.com/donhuvy/java_examples

1 proje = birçok depo . Örneğin: https://github.com/zendframework/zendframework (Zend Framework 3 adlı 1 proje 61 + 1 = 62 depoya sahiptir, inanmayın? Zend Frameworks modüllerini + ana depoyu saymaya izin verin)

Tamamen katılıyorum @Brandon Ibbotson 'ın comment :

GitHub deposu, klasörlerin ve dosyaların bulunabileceği bir "dizin" dir.

Git sözlüğü ile ilgili olarak, Proje gerçek içeriğin (dosyaların) yaşadığı klasördür. Oysa Deposu (repo) git yapılmıştır her değişiklik kaydını tutar hangi iç klasördür proje klasöründe. Ancak genel anlamda, bu ikisi aynı kabul edilebilir. Proje = Depo

Anladığımdaki kavramsal fark, bir projenin birçok repo içerebileceği ve birbirinden bağımsız olabileceği gibi, aynı anda bir repo birçok proje içerebilir. Repo sadece kod için bir depolama alanı, bir proje ise belirli bir özellik için bir görevler topluluğudur.

bu mantıklı mı? Büyük bir repo aynı anda farklı insanlar tarafından çalışılan birçok projeye sahip olabilir (bir monolite birçok farklı özellik eklenir), büyük bir projenin ayrı ama aynı projenin her biriyle etkileşim halinde olan birçok küçük deposu olabilir. diğer - mikro hizmetler? Onun ne yapmak istediğiniz üzerinde kişisel bir almak. Bence repo (depolama) vs proje (görevler) temel fark - eğer yanlışsam lütfen bana bildirin / açıklayın! Teşekkürler.

Bu konu hakkındaki kişisel anlayışım.

Bir proje için, sürüm havuzunu farklı depolarla yapabiliriz. Ve bir havuz için, tüm bir projeyi veya projelerin bir kısmını yönetebilir.

Projenize ilişkin olarak (her birinden bağımsız birkaç prototip uygulaması). Projeyi tek bir havuzla veya birkaç havuzla yönetebilirsiniz, fark:

1. Tek bir depo ile yönetin. Uygulamalardan biri değiştirilirse, tüm proje (tüm uygulamalar) yeni bir versiyona bağlanacaktır.

2. Çeşitli depolarla yönetin. Bir uygulama değiştirilirse, yalnızca uygulamayı yöneten havuzu etkiler. Diğer depoların sürümü değiştirilmedi.