On Github, what’s the difference between a project and a repository?

Asked

Viewed 1,426 times

10

On Github, I saw that I can create a repository, but I can also create a project. What’s the difference between one and the other? When should I create a project instead of a repository and vice versa?

1 answer

7


There is confusion with the term project in the definition of the two things, this is because it is usually understood as the project the folder created during the development that contains the source files.

Anyway, here are the settings used on Github:

Repository

It can be compared to your project’s root folder, whether it’s in the IDE or your filesystem. It will contain the entire file structure and documentation of your sources, as well as a versioning system for it.

It is the most basic structure of Github, usually the Projects are based on the flow of activities occurring in the Repository for the organisation of tasks.

inserir a descrição da imagem aqui

Project

A more complex structure that involves not only the source code view, but the repository view. It resembles the tools of management and monitoring of software projects, it involves from the creation of tasks and the monitoring of its progress.

It’s quite interesting to keep track of issues and pull requests, as well as break down activities and follow a workflow within Github. As shown below, you can see a Kanban with the activities

inserir a descrição da imagem aqui

You can check the in the glossary the term repository, the project was introduced later and its documentation is here.

An interesting detail is that projects can be derived from Repositories or Organizations, for example, the repository of spring-security has no project, but Spring has a project facing their security team.

When I must create one or the other?

If you’re just looking to get your files straight and simple, go to repository.

If within your repository or organization you would like to follow the workflow of projects (repositories), as well as propose activities and track their progress with your collaborators, create a project.

There is no rule for creating a project, it even goes from the need of the team that is working.

Browser other questions tagged

You are not signed in. Login or sign up in order to post.