Rever pedidos de Pull Request

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Quando cria um pull request (PR) e especifica revisores obrigatórios e opcionais, Repositórios do Azure notifica os revisores de que o seu PR está pronto para revisão. Todos os revisores necessários devem aprovar as alterações no seu PR antes que as alterações possam ser integradas no ramo de destino. Para PRs que alteram ramificações críticas, como main, a tua equipa pode ter políticas de ramificação que especificam os revisores ou exigem um número mínimo de revisores. Se as políticas de filiais adicionarem revisores opcionais à sua RP, você poderá mantê-los, exigi-los ou removê-los. Se as políticas de filiais adicionarem revisores necessários à sua RP, você não poderá torná-los opcionais ou removê-los. Para obter informações sobre como atribuir revisores por meio de políticas de ramificação, consulte Incluir revisores de código automaticamente.

Quando reveres um PR, faz comentários construtivos que sejam precisos e fáceis de compreender. Para mais informações, consulte o feedback sobre pull requests.

Você só pode revisar PRs do Azure DevOps no portal da Web usando seu navegador.

Pré-requisitos

Rever alterações

Os pull requests permitem que os revisores designados examinem, discutam e votem nas alterações propostas antes dessas mudanças se fundirem num ramo-alvo. Se os mesmos ficheiros forem alterados tanto no ramo de origem como no de destino, pode haver conflitos de fusão. Analise cuidadosamente os conflitos e edite os ficheiros manualmente para aplicar as alterações corretas de cada ramo. Tirar todas as alterações apenas da fonte ou apenas do alvo com um único clique pode fazer com que percas as alterações necessárias. Pode resolver conflitos no Azure DevOps ou numa ferramenta de desenvolvimento como o Visual Studio.

Para mais informações, consulte Resolver conflitos de fusão.

Solicite uma revisão do código Copilot

Pode pedir ao GitHub Copilot para rever um pull request a par de revisores humanos. O Copilot faz comentários e sugestões diretamente no código alterado, para que possa tratar problemas comuns antes de um revisor humano dar a aprovação final.

Para solicitar uma revisão, abra um pull request e selecione Request ao lado de GitHub Copilot na secção Revisores. Copilot deixa sempre uma revisão Comentário, por isso o seu feedback não satisfaz as políticas do revisor obrigatório nem bloqueia a fusão.

Esta funcionalidade está em pré-visualização pública limitada e requer inscrição. Para configuração, faturação e limites, veja Comece com revisão de código Copilot para pull requests.

Rever as alterações como revisor humano

As etapas a seguir descrevem como os revisores de RPs no Repositórios do Azure podem navegar por uma RP para entender as alterações propostas:

1. No navegador da Web, abra o projeto de equipe para sua organização do Azure DevOps. Escolha Repos>Pull requests para listar os PRs. Uma RP recém-aberta assume como padrão a guia Visão geral .

2. O separador Visão Geral de um PR mostra o título, descrição, revisores, itens de trabalho ligados, histórico, estado e comentários. Leia a descrição do PR para ver as alterações propostas. Veja os comentários para entender as questões levantadas por outros revisores.

   Nota

   Cada ficheiro está marcado com um símbolo "+" ou uma etiqueta "renomear, editar" ao lado do nome para indicar o tipo de alteração. Quando um ficheiro tem mais de 50 por cento de alterações, o Git considera-o renomeado. Este limiar é o padrão para repositórios Git e não pode ser alterado.

   

3. Selecione a guia Arquivos para revisar todas as alterações de conteúdo na ramificação de origem do PR. A vista inicial mostra uma vista resumida de todas as alterações de ficheiros. Escolha o botão Exibir ao lado de um arquivo para exibir apenas as alterações desse arquivo. Se o ficheiro tiver sido modificado, o botão Ver abre uma vista de comparação. Se o arquivo foi adicionado ou excluído, o botão Exibir abre um painel de conteúdo.

   

   Nota

   Por razões de desempenho, a vista de resumo não mostra alterações para um ficheiro com mais de 0,5 MB.

4. Numa visualização de comparação para um ficheiro, podes selecionar um layout de comparação lado a lado ou em linha.

   

   Gorjeta

   Para qualquer ficheiro individual com mais de 5 MB, a visualização de diferenças mostra o conteúdo do ficheiro truncado. Para uma visão diferente do conteúdo completo, descarregue e reveja esses ficheiros usando uma ferramenta local de diferenciação.

   Use a árvore de arquivos à esquerda para exibir outro arquivo ou selecione a raiz da árvore de arquivos para ver uma exibição resumida de todas as alterações de arquivo.

5. Para rever o conjunto de alterações introduzido por pushes específicos na ramificação de origem, selecione um ou mais conjuntos de alterações na lista drop-down de alterações. Quando você seleciona um ou mais conjuntos de alterações, a visualização de comparação é atualizada para mostrar apenas as alterações dos conjuntos de alterações selecionados. Esta funcionalidade é útil quando as alterações são enviadas para o PR desde a sua última avaliação e só quer ver as novas alterações. A lista suspensa de alterações nomeia cada conjunto de alterações com a mensagem de confirmação da confirmação final em cada operação de push.

   

   Gorjeta

   Mantenha pressionada a tecla Shift ao selecionar múltiplos conjuntos de alterações na lista suspensa de alterações.

6. Escolha o separador Atualizações para ver todos os conjuntos de alterações enviados e confirmar que não perdeu nenhuma alteração no branch de origem. Os conjuntos de alterações são numerados e o conjunto de alterações mais recente aparece no topo da lista. Cada conjunto de alterações mostra as confirmações que foram enviadas por push nessa operação de push. Um conjunto de alterações enviado com força não sobrescreve o histórico do conjunto de alterações e aparece na lista de conjuntos de alterações como qualquer outro conjunto de alterações.

   

7. Selecione o separador Commits para ver o histórico de commits da ramificação de origem após ter-se divergido da ramificação de destino. O histórico de commits no separador Commits é substituído se o autor do PR fizer um push forçado de um histórico de commits diferente, pelo que os commits mostrados no separador Commits podem diferir dos commits mostrados no separador Atualizações.

   

Usar comentários

Autores e revisores de RP podem se comunicar uns com os outros adicionando e respondendo a comentários de RP. Quando rever um PR, use os comentários para apontar problemas com as alterações propostas, sugerir alterações e responder a comentários anteriores. Procure um feedback construtivo que seja preciso e fácil de entender. Dirija-se diretamente aos destinatários usando o @username. Referenciar itens de trabalho usando #workitemID e outros RPs usando !pullrequestID. Às vezes, os autores de RP criam comentários para si mesmos para fins de documentação.

Fornecer feedback nos comentários

Se seus comentários se aplicarem a uma linha específica ou a um intervalo de linhas em um arquivo, adicione um comentário nesse local dentro do arquivo:

1. Na guia Arquivos de uma RP, passe o mouse sobre a linha em que deseja comentar e selecione o botão de comentário para abrir uma caixa de comentário embutida. Você também pode selecionar várias linhas e, em seguida, selecionar o botão de comentário que aparece quando você passa o mouse sobre essas linhas.

   

2. Digite seu comentário na caixa de comentários e escolha Comentário.

   

Se os comentários se aplicarem a todo o arquivo, adicione um comentário no nível do arquivo selecionando Adicionar comentário no menu de opções do arquivo:

Para fornecer comentários gerais não relacionados a um arquivo específico, adicione um comentário na guia Visão geral :

Os revisores de RP também podem usar comentários para sugerir alterações em linhas de arquivo específicas, conforme descrito na próxima seção.

Sugerir alterações nos comentários

Use os comentários para sugerir texto de substituição para uma ou mais linhas num ficheiro:

1. Na guia Arquivos de uma RP, passe o mouse sobre a linha em que deseja comentar e selecione o botão de comentário para abrir uma caixa de comentário embutida. Você também pode selecionar várias linhas e, em seguida, selecionar o botão de comentário que aparece quando você passa o mouse sobre essas linhas. Se for aceite, o seu conteúdo sugerido substitui a linha ou linhas a que o seu comentário foi adicionado.

   

2. Selecione o ícone de lâmpada sob a caixa de comentários para fazer as alterações sugeridas na caixa de comentários dentro de um bloco de código cercado e, em seguida, escolha Comentário. Não vês um ícone de lâmpada se adicionares um comentário ao código original (lado esquerdo) de uma vista diferente lado a lado.

   

Os autores de PR podem aceitar a sua sugestão:

1. Escolha Aplicar alterações para preparar a mudança para um compromisso.

   

2. Escolha Confirmar todas as alterações para confirmar todas as alterações em estágios. Os autores de RP podem desmontar uma sugestão escolhendo Desfazer mudança.

   

Editar ou excluir comentários

Edite ou elimine o seu comentário passando o rato sobre o comentário e escolhendo o ícone de editar ou eliminar :

Gostar de comentários

Os autores e revisores de RP podem gostar do seu próprio comentário ou de outra pessoa passando o mouse sobre o comentário e escolhendo o ícone de polegar para cima:

Os comentários com gostos mostram um ícone de polegar para cima preenchido e o número de gostos. Passe o cursor sobre o ícone de polegar para cima para ver a lista de pessoas que curtiram o comentário.

Responder aos comentários

Os autores de RP devem responder aos comentários para que os revisores saibam como estão lidando com o feedback e as sugestões:

1. Para responder a um comentário, digite sua resposta no campo Escrever uma resposta . Dirija-se diretamente aos destinatários usando o @username. Referenciar itens de trabalho usando #workitemID e outros RPs usando !pullrequestID.

   

2. Depois de inserir a resposta, selecione Responder e resolver se a resposta for final. Caso contrário, selecione Responder.

   

   Se selecionares Responder e resolver, o estado do comentário muda para Resolvido. Os autores de RP também podem alterar diretamente o status de um comentário, conforme descrito na próxima seção.

Alterar o status do comentário

Os novos comentários começam com um estado Ativo . Os autores das RP atualizam o estado durante o processo de revisão para indicar como abordaram o feedback e sugestões dos revisores. Os autores de RP podem selecionar um status de comentário na lista suspensa de status:

• Ativo: O estado padrão para novos comentários.
• Pendente: O problema neste comentário está a ser revisto e aguarda algo mais.
• Resolvido: O problema neste comentário foi resolvido.
• Não vai resolver: O problema neste comentário é referido mas não será resolvido.
• Encerrado: A discussão neste comentário está encerrada.

Os autores e revisores de PR podem acompanhar o progresso dos PRs filtrando o status dos comentários, conforme descrito na próxima seção.

Filtrar comentários

Você pode selecionar quais comentários ou atualizações são exibidos na guia Visão geral selecionando uma opção de filtro na lista suspensa do filtro de comentários. Por exemplo, selecione a opção Filtro Novidades para ver novos comentários e atualizações desde a última vez que abriu o PR. Cada opção de filtro mostra o número de itens para sua categoria.

Editar ficheiros

Por conveniência, os autores de RP podem editar arquivos diretamente no Repositórios do Azure. Por exemplo, pode aceitar a alteração de código sugerida por um revisor e querer fazer alterações semelhantes noutro local.

1. Selecione Repos > Ficheiros, selecione o ramo de origem do PR, selecione um ficheiro e, em seguida, escolha Editar.

   

2. Faça as alterações no editor e escolha Confirmar para abrir a caixa de diálogo Confirmar .

   

3. Na caixa de diálogo Confirmar, edite a mensagem de confirmação, se necessário, e escolha Confirmar para confirmar e enviar as alterações para o PR.

   

Rastrear arquivos revisados

Os revisores de RP podem acompanhar os arquivos revisados escolhendo Marcar como revisado no menu de opções de arquivo ou marcando a caixa de seleção ao lado de um arquivo ou pasta:

Votação das alterações ao PR

az repos pr set-vote --id
                     --vote {approve, approve-with-suggestions, reject, reset, wait-for-author}
                     [--detect {false, true}]
                     [--org]
                     [--subscription]

az repos pr set-vote --id 21 --vote approve --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000  Approved  False

az repos pr set-vote --id 21 --vote reset --output table

Name            Email                ID                                    Vote      Required
--------------  ------------------- -------------------------------------  --------  ----------
Jamal Hartnett  jamalh@fabrikam.com  00000000-0000-0000-0000-000000000000            False

Conclua um PR

Os autores de RP podem selecionar uma opção de resolução de RP:

• Concluir: Conclua a PR agora se todos os revisores obrigatórios a tiverem aprovado e se todas as políticas obrigatórias da ramificação estiverem cumpridas.
• Definir conclusão automática: Concluir automaticamente o PR quando todos os revisores necessários o aprovarem e todas as políticas de ramificação obrigatórias forem cumpridas.
• Marcar como rascunho: Define o PR como rascunho para indicar que ainda não está pronto para revisão. Para um rascunho de PR, selecione Publicar para remover o estado do rascunho e marque-o pronto para revisão.
• Abandonar: Fechar a PR. Para um PR abandonado, selecione Reativar para o restaurar.

Para mais informações, consulte Completar o pull request.

Passo seguinte

Artigos relacionados

• Comece com revisão de código Copilot para pull requests
• Notificações de atualização de pull requests
• Sobre solicitações pull e permissões