Melhores práticas para Projects

Confira dicas para gerenciar projetos.

Neste artigo

Você pode usar Projects para gerenciar seu trabalho no GitHub, onde os seus problemas e suas solicitações de pull são mantidos. Leia sobre as dicas para gerenciar seus projetos de forma eficiente e eficaz. Para obter mais informações sobre Projects, confira Sobre Projects.

Dividir problemas grandes em problemas menores

Dividir um problema grande em problemas menores torna o trabalho mais gerenciável e permite que os integrantes da equipe trabalhem em paralelo. Isso também gera pull requests menores, que são mais fáceis de revisar.

Para acompanhar como os problemas menores encaixam-se na meta maior, marcos ou etiquetas. Para saber mais, confira Sobre marcos e Gerenciar etiquetas.

Comunicar

Os problemas e pull requests incluem funcionalidades embutidas para permitir que você se comunique facilmente com os seus colaboradores. Use @mentions para alertar uma pessoa ou toda a equipe sobre um comentário. Atribua colaboradores a problemas para comunicar responsabilidade. Vincule a problemas relacionados ou pull requests para comunicar como eles estão conectados.

Faça uso das atualizações de descrição, LEIAME e status

Use a descrição do seu projeto e o README para compartilhar informações sobre o projeto.

Por exemplo:

  • Explicando a finalidade do projeto.
  • Descrevendo as visualizações do projeto e como usá-las.
  • Incluindo links relevantes e pessoas para entrar em contato e obter mais informações.

Os READMEs de projeto são compatíveis com Markdown, o que permite que você utilize imagens e formatação avançada, como links, listas e cabeçalhos. Para saber mais, confira Criar um project.

Também é possível compartilhar atualizações de alto nível com outros usuários do projeto ao postar atualizações de status. As atualizações de status permitem que você marque o projeto com um status, como "Encaminhado" ou "Em risco", defina datas de início e de destino e compartilhe atualizações por escrito com sua equipe. Para saber mais, confira Como compartilhar atualizações do project.

Usar visualizações

Use as visualizações do projeto para ver o seu projeto de ângulos diferentes.

Por exemplo:

  • Filtrar por status para visualizar todos os itens não iniciados
  • Agrupar por um campo personalizado de prioridade para monitorar o volume de itens de alta prioridade
  • Ordenar por um campo de data personalizado para exibir os itens com a data de envio mais recente

Para saber mais, confira Alterando o layout de uma exibição.

Tenha uma única fonte de verdade

Para evitar que as informações não fiquem sincronizadas, mantenha uma única fonte de verdade. Por exemplo, monitore uma data de envio em um único local, em vez de se espalhar por vários campos. Posteriormente, se a data de envio for alterada, você deverá apenas atualizar a data em um só lugar.

Os Projects ficam automaticamente atualizados com os dados do GitHub, como os destinatários, os marcos e as etiquetas. Quando um desses campos é alterado em um problema ou pull request, a alteração é refletida automaticamente no seu projeto.

Usar automação

Você pode automatizar as tarefas para gastar menos tempo com trabalho e mais tempo no próprio projeto. Quanto menos você precisar se lembrar de fazer manualmente, mais provável será que o seu projeto fique atualizado.

Os Projects oferecem fluxos de trabalho internos. Por exemplo, quando um problema é fechado, você pode definir automaticamente o status como "Concluído". Você também pode configurar fluxos de trabalho internos para arquivar itens automaticamente quando eles atenderem a certos critérios e para adicionar itens de um repositório automaticamente quando corresponderem a um filtro.

Além disso, GitHub Actions e a API do GraphQL permitem que você automatize tarefas rotineiras de gerenciamento de projetos. Por exemplo, para manter o controle das solicitações de pull que estão aguardando revisão, crie um fluxo de trabalho que adiciona uma solicitação de pull a um projeto e define o status como "precisa de revisão". Esse processo pode ser disparado automaticamente quando uma solicitação de pull é marcada como "pronta para revisão".

Usar diferentes tipos de campos

Aproveite os vários tipos de campo para atender às suas necessidades.

Use um campo de iteração para agendar o trabalho ou criar uma linha do tempo. Você pode agrupar por iteração para ver se os itens estão equilibrados entre iterações, ou você pode filtrar para focar em uma única iteração. Os campos de iteração também permitem ver o trabalho que você realizou em iterações anteriores, o que pode ajudar no planejamento de velocidade e refletir sobre as realizações da sua equipe. Os campos de iteração também são compatíveis com pausas para mostrar quando você e sua equipe estão tirando tempo de suas iterações. Para saber mais, confira Sobre campos de iteração.

Use um único campo de seleção para rastrear informações sobre uma tarefa com base em uma lista de valores predefinidos. Por exemplo, monitore a prioridade ou a fase do projeto. Como os valores são selecionados a partir de uma lista predefinida, você pode facilmente agrupar ou filtrar focar em itens com um valor específico.

Para obter mais informações sobre os diferentes tipos de campos, confira Noções básicas sobre campos.