Propostas de mesclagem
Peça a revisão das alterações de uma branch antes que elas cheguem a outra branch.
Visão geral
Uma proposta de merge registra uma solicitação para mesclar as alterações de uma branch em outra e permite que um colega revise o diff antes disso acontecer. Qualquer pessoa com acesso de edição ao agente pode abrir uma proposta, inclusive para uma branch na qual não pode fazer merge. Fazer o merge da proposta ainda exige acesso de escrita à branch de destino, então uma proposta permite que uma alteração chegue a uma branch protegida sem conceder permissões de merge a todos os colaboradores.
As propostas de merge adicionam uma etapa opcional de revisão ao fazer merge de branches diretamente. Faça o merge diretamente quando tiver acesso de escrita à branch de destino e não precisar de uma segunda opinião. Abra uma proposta quando quiser que ela seja revisada primeiro ou quando a branch de destino estiver protegida e você não tiver acesso de escrita a ela.
Disponibilidade
As propostas de merge estão em alpha. Quando várias branches de um agente estão em andamento ao mesmo tempo, fica difícil acompanhar quais estão prontas e seguras para receber merge. As propostas de merge oferecem à equipe um único lugar para revisar e discutir as alterações de uma branch, comparar taxas de aprovação em testes entre branches e ver as conversas mais recentes da branch.
A versão alpha é um primeiro passo rumo a um workflow no estilo CI/CD para agentes, semelhante aos pull requests do GitHub. Adições planejadas para as próximas semanas incluem:
- Testes obrigatórios que precisam ser aprovados antes que uma proposta possa receber merge.
- Solicitação de aprovações de revisores específicos.
- Configuração de responsáveis por diferentes partes de um agente.
Ciclo de vida da proposta
Cada proposta tem um destes status:
Enquanto uma proposta está aberta, os revisores deixam um destes pareceres. O parecer mais recente de um revisor substitui qualquer anterior desse mesmo revisor:
Abrir uma proposta
Abra uma proposta a partir da branch cujas alterações você quer revisar:
Na lista de branches
Na aba Propostas
Na aba Branches do agente, abra o menu de opções da branch de origem e selecione **Abrir proposta de merge **.
Dê à proposta um título, uma descrição opcional e escolha uma branch de destino entre as outras branches não arquivadas do agente. Abrir uma proposta não altera nenhuma das branches; apenas registra a solicitação.
Um par de branches de origem e destino pode ter no máximo uma proposta aberta por vez. Feche a existente antes de abrir outra entre as mesmas duas branches.
Revisar uma proposta
A página de uma proposta tem estas abas:
Visão geral
Alterações
Execuções de teste
Conversas
A descrição, o histórico de revisões e um formulário para deixar uma revisão.
Qualquer pessoa com acesso de edição ao agente, exceto o autor da proposta, pode deixar uma revisão com um comentário opcional. Os comentários aceitam markdown.
Fazer merge de uma proposta
Fazer o merge de uma proposta realiza o mesmo merge de branch que o merge direto, incluindo a resolução de conflitos e a opção de arquivar a branch de origem depois. Antes de poder receber merge, uma proposta precisa atender a estes requisitos:
- O usuário que faz o merge tem acesso de escrita às branches de origem e destino. Em uma branch protegida, isso significa ser administrador do workspace.
- O parecer mais recente de nenhum revisor é “alterações solicitadas”. Um revisor que solicitou alterações precisa aprovar antes que a proposta possa receber merge.
- A proposta tem pelo menos uma aprovação de alguém que não seja seu autor. Administradores do workspace podem fazer o merge sem essa aprovação.
Fazer o merge de uma proposta fecha automaticamente qualquer outra proposta aberta da mesma branch de origem, pois as alterações dela agora avançaram.
Fechar uma proposta
Uma proposta pode ser fechada sem merge a qualquer momento enquanto estiver aberta. O autor e os revisores podem editar seu título e descrição até ela ser fechada.
- Quando o autor fecha a própria proposta, ela é registrada como retirada.
- Quando outra pessoa a fecha, ela é registrada como rejeitada.
- Arquivar a branch de origem fecha automaticamente qualquer proposta aberta dela ou para ela, registrada como branch_archived.
Propostas de merge e Architect
O Architect tem acesso de leitura às branches de um agente quando você pergunta sobre branches, versões e merges, então ele pode ajudar você a entender o diff de uma proposta ou resumir revisões abertas em uma conversa.