Blog

Github Projects: Organizando seus Projetos no GitHub

20 de mar. de 2024

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

a. Acesse a aba “Projetos” em seu perfil.

Aba Projetos no perfil do GitHub

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

Escolha do template do projeto: tabela ou quadro

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).

Quadro kanban do GitHub Projects com cards

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.

a. Acesse as configurações do projeto.

Configurações do projeto no GitHub Projects

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

Criação do campo customizado Projeto com suas opções

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

Campo Project nas configurações de um card

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

Quadro exibindo o projeto selecionado em cada card

Criando uma issue

a. No card desejado, clique no botão para criar uma Issue e selecione o repositório relevante.

Botão para converter um card em issue e escolher o repositório

Criando um Pull Request

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

Atalho para abrir a issue a partir do card

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

Criação de branch vinculada à issue

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

Branches criadas para a issue

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

Sugestão de criação de pull request após o push

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

Pull request criado e vinculado à issue

No seu card mostra um link para a PR.

Card do quadro com o link para o pull request

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.

Automações de workflow do GitHub Projects

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!

Pedir orçamento

Conte sobre o seu projeto e eu respondo por e-mail.