Глава 23 · Часть II · Планируем SafeSort на GitHub

Repository и GitHub Project — в чём разница

Repository хранит код; GitHub Project отслеживает статус задач — два разных, независимых объекта.

SafeSort · Часть 2 из 6
Git и GitHubПланированиеПроектРеализацияТесты и CIРелиз

Часть I уже разделила Git и GitHub. Здесь — вторая частая путаница: репозиторий и GitHub Project — тоже разные, независимые понятия, и легко решить, что раз оба слова начинаются с «проект», это одно и то же.

RepositoryGitHub Project
код, файлы, история коммитовзадачи, их статус, представления (доска/таблица)
ветки, теги, Pull Requestможет объединять Issues сразу из нескольких репозиториев
отвечает на вопрос «что уже сделано»отвечает на вопрос «что нужно сделать и в каком порядке»
обязателен — без него нет коданеобязателен — можно работать вообще без Project
Issueформулировка задачиGitHub Projectстатус, приоритет,представлениеВетка / PullRequestработа над задачей иеё результат
Project не хранит код — он отслеживает статус задач, которые ссылаются на репозиторий
Один Project может охватывать несколько репозиториев
GitHub Project — не часть репозитория и не находится «внутри» него: это отдельный объект, который может показывать Issues и Pull Request сразу из нескольких репозиториев одной организации. Для SafeSort в этой главе используется один Project на один репозиторий — но так бывает не всегда.
Официальная документация
About Projects
Перевод и учебная адаптация официальной документации GitHub. Исходный материал — CC BY 4.0.

Коротко

  • Repository хранит код и историю; GitHub Project отслеживает статус задач — это разные объекты.
  • Project не обязателен: можно вести репозиторий вообще без него.
  • Один Project может объединять Issues из нескольких репозиториев организации.