Проект проти сховища в GitHub

У GitHub, яка концептуальна різниця між проектом (який можна створити всередині сховища) і сховищем?

Я бачив кілька подібних питань ( тут , тут і тут ) в SO, але жодне з них не пояснює, що таке проект GitHub, що таке сховище GitHub і коли використовувати кожне з них.

Буду вдячний, якщо хтось може пояснити кожен термін і навести приклад, коли потрібно використовувати / створити кожен. Наприклад, якщо у мене є кілька додатків-прототипів, всі незалежні один від одного, що я створюю, щоб організованим чином керувати вихідним кодом для всіх?

Нещодавно GitHub представив нову функцію під назвою Projects . Це забезпечує візуальну дошку, характерну для багатьох інструментів управління проектами:

Repository як описано на GitHub:

Репозиторій - найосновніший елемент GitHub. Їх найпростіше уявити як папку проекту. Репозиторій містить усі файли проекту (включаючи документацію) та зберігає історію редагування кожного файлу. Репозиторії можуть мати декілька співавторів і можуть бути як державними, так і приватними.

Проект як документовано на GitHub:

Дошки проектів на GitHub допоможуть вам упорядкувати та визначити пріоритетну роботу. Ви можете створювати дошки проектів для роботи з особливими функціями, вичерпними дорожніми картами або навіть випускати контрольні списки. За допомогою проектних дощок ви маєте можливість створювати індивідуальні робочі процеси, що відповідають вашим потребам.

Частина плутанини полягає в тому, що нова функція, Проекти, суперечить перевантаженому використанню терміна проект у вищезазначеній документації.

Факт 1: Проекти та сховища завжди були синонімами на GitHub.

Факт 2: Це вже не так.

Є багато плутанини щодо сховищ та проектів. Раніше обидва терміни користувалися значною мірою взаємозамінно користувачами та власною власною документацією GitHub. Це відображається в деяких відповідях та коментарях, які пояснюють тонкі відмінності між цими термінами і коли один віддавав перевагу іншому. Різниця завжди була тонка, наприклад, наприклад, як трекер випуску є частиною проекту, але не є частиною сховища, яке може вважатися суто git річ тощо.

Більше не.

В даний час репозиції та проекти стосуються різних типів організацій, які мають окремі API :

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

З тих пір більше не правильно називати проект репо або навпаки. Зауважте, що це часто плутається в офіційній документації, і шкода, що термін, який уже широко застосовувався, був обраний як назва нової сутності, але це так, і ми повинні з цим жити.

Наслідком цього є те, що репости та проекти зазвичай плутаються, і кожного разу, коли ви читаєте про проекти GitHub, вам належить задатися питанням, чи це насправді про проекти чи про репости. Якби вони обрали якусь іншу назву чи абревіатуру на кшталт "proj", тоді ми могли б знати, що йдеться про новий тип сутності, точний об'єкт з конкретними властивостями або загально кажучи репо-подібний проектний вид.

Термін, який, як правило, однозначний, - це «дошка проектів» .

Про що ми можемо дізнатися з API

Перша кінцева точка в документації API Проектів:

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

описується як: Список проектів сховища . Це означає, що сховище може мати багато проектів. Тож ці двоє не можуть означати одне і те ж. Він включає відповідь, якщо проекти відключені :

{
  "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 Project: Він також є одним із ресурсів у Git Repository, і основне його використання полягає в управлінні проектами за допомогою візуальної дошки. Якщо ви створюєте проект у сховищі Git, створіть візуальну дошку, як дошку Kanban для управління проектом.

Таким чином, ви можете мати кілька проектів у сховищі.

Загалом на GitHub 1 сховище = 1 проект . Наприклад: https://github.com/spring-projects/spring-boot . Але це не важке правило.

1 сховище = багато проектів . Наприклад: https://github.com/donhuvy/java_examples

1 проект = багато сховищ . Наприклад: https://github.com/zendframework/zendframework (1 проект під назвою Zend Framework 3 має 61 + 1 = 62 сховища, не вірте? Нехай вважають модулі Zend Frameworks + головне сховище)

Я повністю згоден з @Brandon Ібботсон «s коментар :

Репозиторій GitHub - це лише "каталог", де можуть існувати папки та файли.

Що стосується лексики git, то Project - це папка, в якій живе власний вміст (файли). Тоді як Repository (repo) - це папка, всередині якої git зберігає запис про всі зміни, внесені в папку проекту . Але в загальному сенсі ці двоє можна вважати однаковими. Проект = сховище

Концептуальна різниця в моєму розумінні того, що проект може містити багато репо і не залежать один від одного, тоді як одночасно репо може містити багато проектів. Repo є просто місцем зберігання коду, тоді як проект є сукупністю завдань для певної функції.

Чи має це сенс? У великому РЕПО може бути багато проектів, над якими працюють різні люди одночасно (в моноліт додається безліч відмінностей), у великого проекту може бути багато невеликих репостів, які є окремими, але є частиною одного і того ж проекту, який взаємодіє з кожним інше - мікросервіси? Це особисте сприйняття того, що ви хочете зробити. Я думаю, що головна відмінність - репо (зберігання) проти проекту (завдання) - якщо я помиляюся, будь ласка, дайте мені знати / поясніть! Дякую.

Це моє особисте розуміння теми.

Для проекту ми можемо здійснювати контроль версій різними сховищами. А для сховища він може керувати цілим проектом або частиною проектів.

Що стосується вашого проекту (кілька прототипів додатків, які не залежать від кожного). Ви можете керувати проектом одним сховищем або кількома сховищами, різниця:

1. Управління одним сховищем. Якщо одне із застосувань буде змінено, весь проект (усі програми) буде прийнято на нову версію.

2. Управління кількома сховищами. Якщо одна програма буде змінена, вона вплине лише на сховище, яке керує програмою. Версія для інших сховищ не змінена.