Github Projects
Tags: github, board, beginners, tutorial
Published: 2024-03-20 11:30:11

## Introdução

O Github Projects é uma ferramenta poderosa para planejar e acompanhar o progresso dos seus projetos diretamente no Github. Funciona como um quadro kanban integrado ao seu repositório, onde os cards estão diretamente ligados às suas Issues e Pull Requests.

## Vantagens do Github Projects

- **Avaliação Básica do Desempenho:** Permite medir de forma básica a performance das entregas.
- **Integração com Issues e Pull Requests:** Os cards estão vinculados diretamente às suas Issues e Pull Requests, facilitando o acompanhamento do desenvolvimento.
- **Visualização dos Arquivos Alterados:** Ao visualizar um card, é fácil encontrar os arquivos alterados para a implementação.
- **Atribuição ao Responsável:** Possui vínculo com o usuário responsável pela implementação.
- **Campos Customizados:** Oferece a possibilidade de criação de campos customizados nos cards para uma melhor organização.

## Guia Passo a passo

### Criando um projeto

1. Acesse a aba "Projetos" em seu perfil.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/m8qmcc7gguc8suph49x1.png)

1. Selecione um template de início, escolhendo entre Tabela ou Quadro. Recomendamos o modelo de Quadro pela sua visualização em cards.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/ciu6on8psf12dnfjp1nz.png)

Até então é um quadro como em qualquer outra ferramenta e os cars podem ser inseridos clicando em `Add item` ou como atalho `command + space` (Mac).

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/56g35vqk4f2j55chs8xp.png)


### Criando campos customizados

É possível criar campos para ajudar na organização, analise da sprint e de vários projetos. Para o meu quadro criei um campo para dizer sobre qual projeto é o card.

1. Acesse as configurações do projeto.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/2c8lclpidkjzsvcyiwmy.png)

2. Crie um novo campo, como por exemplo "Projeto" e as possíveis opções, para melhor organização e análise.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/7esj1x2qi1f4n3dv0ryp.png)

Voltando no board e selecionando um card, esse novo campo chamado `Project`, aparece nas configurações do card. 

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/2svk8cn2aswv1a6at7p9.png)

E também aparece no board com o projeto selecionado para o card.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/lje3m9dlfesozuoq3gl8.png)


### Criando uma issue

1. No card desejado, clique no botão para criar uma Issue.
2. Selecione o repositório relevante.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/qx098em25bid11af0t9s.png)


### Criando um Pull Request

1. No card, utilize o atalho para abrir uma Issue.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/09nt4klyd1znq72ee6a0.png)

2. Na página da Issue, crie ou vincule uma branch.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/id0yggr8buwpjfibml9i.png)

Como para implementar esse layout eu preciso iniciar o react native, vou separar isso em uma branch de start e vou criar outra para a implementação do layout

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/s9pjwsg4x4ywnwblbtej.png)

Após feito push da criação do react native, na aba Pull Request, aparece uma sugestão de criação.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/t9hqa7zktslg2ire8h3u.png)

Após preencher o que você fez e confirmar, vai ter uma PR como esta.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/g4bavimen4x8rbaf2s1z.png)



No seu card mostra um link para a PR.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/rzq93g9wwoyt6ysfn19x.png)


### Configurações Automáticas

O Github Projects oferece opções de automação para otimizar o workflow, como mover automaticamente um card para a coluna "Concluído" quando uma Issue ou Pull Request é fechada.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/s06vrp4x14rkvn8wh4ib.png)


## **Conclusão**

Este tutorial apresentou as funcionalidades básicas do Github Projects, uma ferramenta essencial para o gerenciamento eficiente de projetos no Github. Você já utilizava essa ferramenta? Compartilhe suas dicas nos comentários!