APRENDER. PRATICAR. EVOLUIR.Conceito e mecanismo
Issues registam trabalho e problemas; PRs propõem alterações; Discussions permitem explorar perguntas e opções sem assumir logo uma tarefa fechável. Liga a alteração ao problema para que APS, desenvolvimento e gestão encontrem a mesma decisão. As palavras de fecho na descrição da PR dependem da branch de destino predefinida; um merge para outra branch não satisfaz essa condição. Uma simples referência a um número também não significa execução ou aceitação. Templates ajudam a recolher contexto, impacto e reprodução consistente. Assignees, labels e filtros ajudam a encaminhar trabalho, mas precisam de critérios compreendidos pela equipa. Uma issue fechada é um estado do registo, não prova automática de recuperação do serviço.
Aplicação guiada
Num handover fictício, substitui cadeias de mensagens dispersas por uma síntese com links para evidência autorizada. Ajusta notificações à responsabilidade para reduzir ruído sem perder pedidos de revisão. Gists são úteis para exemplos pequenos, mas secret significa não listado, não privado: quem obtiver o URL pode ler. Nunca uses essa ausência de pesquisa como controlo para logs restritos. Wikis apoiam documentação mais extensa; Pages publica sites estáticos e tem visibilidade própria. Em Enterprise Cloud sem EMU, um site de projeto pode ser público mesmo com repositório privado. Confirma o acesso efetivo do site antes de publicar documentação interna. O canal escolhido deve corresponder à classificação e aos destinatários, não apenas à conveniência.
Closes #42 numa PR para release-candidate não tem o mesmo efeito de uma PR para a branch predefinida.
Armadilhas comuns
Menção como fecho; issue fechada como serviço recuperado; secret gist como privado; repositório privado como site privado.
Tópicos relacionados: Git, estado local e colaboração · Repositórios, ficheiros de orientação e manutenção · Automação, ambientes de desenvolvimento e IA
Mantém problema, alteração, evidência e audiência ligados ao mesmo fluxo.
Referência: PR issue linkage and default branch · GH-900 skills measured January2026;study guide updated2026-02-19