Analisando uma pull request - Amazon CodeCatalyst

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Analisando uma pull request

Você pode usar o CodeCatalyst console da Amazon para analisar e comentar de forma colaborativa as alterações incluídas em uma pull request. Você pode adicionar comentários a linhas individuais de código na diferença entre as ramificações de origem e de destino ou na diferença entre as revisões da pull request. Você pode optar por criar um resumo dos comentários deixados sobre as alterações de código na pull request para ajudá-lo a entender rapidamente o feedback deixado por outros usuários. Você também pode optar por criar um ambiente de desenvolvimento para trabalhar no código.

nota
nota

Desenvolvido pelo Amazon Bedrock: AWS implementa a detecção automática de abusos. Como os recursos Escrever descrição para mim, Criar resumo de conteúdo, Recomendar tarefas, Usar o Amazon Q para criar ou adicionar recursos a um projeto e Atribuir problemas ao Amazon Q com o Amazon Q Developer Agent para recursos de desenvolvimento de software são criados no Amazon Bedrock, os usuários podem aproveitar ao máximo os controles implementados no Amazon Bedrock para reforçar a segurança e o uso responsável da inteligência artificial (IA).

dica

Você pode configurar sobre quais eventos de pull request você receberá e-mails como parte do seu perfil. Para ter mais informações, consulte Enviando notificações do Slack e por e-mail de CodeCatalyst.

As pull requests mostram qual será a diferença entre a revisão da pull request e o commit que foi a ponta da ramificação de destino quando você criou a pull request. Isso é chamado de base de mesclagem. Para obter mais informações sobre diferenças e bases de mesclagem no Git, git-merge-baseconsulte a documentação do Git.

dica

Ao trabalhar no console, especialmente se você tem uma pull request aberta há algum tempo, considere atualizar seu navegador para garantir que você tenha a revisão mais recente disponível para uma pull request antes de começar a revisá-la.

Para revisar uma pull request no CodeCatalyst console
  1. Navegue até o projeto.

  2. Navegue até as pull requests fazendo o seguinte:

    • Se a pull request estiver listada na página do projeto, escolha-a na lista.

    • Se a pull request não estiver listada na página do projeto, escolha Exibir tudo. Use os filtros e classifique para encontrar a pull request e, em seguida, escolha-a na lista.

    • No painel de navegação, escolha Código e, em seguida, escolha Pull requests.

  3. Escolha a pull request que você deseja revisar na lista. Você pode filtrar a lista de pull requests digitando parte do nome na barra de filtro.

  4. Em Visão geral, você pode revisar o nome e o título da pull request. Você pode criar e visualizar comentários deixados na própria pull request. Você também pode visualizar os detalhes da pull request, incluindo informações sobre execuções de fluxo de trabalho, problemas vinculados, revisores, o autor da pull request e estratégias de mesclagem viáveis.

    nota

    Comentários deixados em linhas de código específicas aparecem em Alterações.

  5. (Opcional) Para adicionar um comentário que se aplique a toda a pull request, expanda Comentários na pull request e escolha Criar comentário.

  6. (Opcional) Para ver um resumo de todos os comentários deixados sobre as alterações nas revisões desse pull request, escolha Criar resumo de comentários.

    nota

    Essa funcionalidade exige que os recursos generativos de IA estejam habilitados para o espaço e só esteja disponível na região Oeste dos EUA (Oregon). Para obter mais informações, consulte Gerenciamento de recursos generativos de IA.

  7. Em Alterações, você pode ver as diferenças entre a ramificação de destino e a revisão mais recente da pull request. Se houver mais de uma revisão, você poderá alterar quais revisões são comparadas na diferença entre elas. Para obter mais informações sobre revisões, consulteRevisões.

    dica

    Você pode ver rapidamente quantos arquivos têm alterações na pull request e quais arquivos na pull request têm comentários sobre eles, em Arquivos alterados. O número de comentários exibidos ao lado de uma pasta indica o número de comentários nos arquivos dessa pasta. Expanda a pasta para ver o número de comentários de cada arquivo na pasta.

  8. Para alterar a forma como as diferenças são exibidas, escolha entre Unificado e Dividido.

  9. Para adicionar um comentário a uma linha na pull request, vá até a linha na qual você deseja comentar. Escolha o ícone de comentário que aparece para essa linha, insira um comentário e escolha Salvar.

  10. Para visualizar as alterações entre as revisões em uma pull request ou entre suas ramificações de origem e destino, escolha entre as opções disponíveis em Comparação. Os comentários sobre as linhas nas revisões são preservados nessas revisões.

  11. Se você configurou seu fluxo de trabalho para gerar um relatório de cobertura de código sobre acionadores de pull request, você pode ver as descobertas de cobertura de linha e filial na pull request relevante. Para ocultar as descobertas de cobertura de código, escolha Ocultar cobertura de código. Para ter mais informações, consulte Relatórios de cobertura de código.

  12. Se quiser fazer alterações no código da pull request, você pode criar um ambiente de desenvolvimento a partir da pull request. Escolha Criar ambiente de desenvolvimento. Opcionalmente, adicione um nome para o Dev Environment ou edite sua configuração e escolha Create.

  13. Em Relatórios, você pode visualizar os relatórios de qualidade nessa pull request. Se houver mais de uma revisão, você poderá alterar quais revisões são comparadas na diferença entre elas. Você pode filtrar os relatórios por nome, status, fluxo de trabalho, ação e tipo.

    nota

    Um fluxo de trabalho deve ser configurado para gerar relatórios para que eles apareçam em suas pull requests. Para ter mais informações, consulte Configurando relatórios de qualidade em uma ação.

  14. Para ver um relatório específico, escolha-o na lista. Para ter mais informações, consulte Testando com fluxos de trabalho.

  15. Se você estiver listado como revisor dessa pull request e quiser aprovar as alterações, verifique se está visualizando a revisão mais recente e escolha Aprovar.

    nota

    Todos os revisores obrigatórios devem aprovar uma pull request antes que ela possa ser mesclada.