Revisar o código com solicitações pull no Amazon CodeCatalyst - Amazon CodeCatalyst

Revisar o código com solicitações pull no Amazon CodeCatalyst

Uma solicitação pull é a principal maneira para você e outros membros do projeto revisarem, comentarem e mesclarem alterações de código de uma ramificação para outra. Você pode usar solicitações pull para revisar alterações de código de maneira colaborativa em caso de alterações ou correções relativamente pequenas, adições significativas de recursos ou novas versões do seu software lançado. Se você usar problemas para rastrear o trabalho em seu projeto, poderá vincular problemas específicos a solicitações pull para ajudar a rastrear quais problemas estão sendo resolvidos pelas alterações de código na solicitação pull. Quando você cria, atualiza, comenta, mescla ou fecha uma solicitação pull, um e-mail é enviado automaticamente para o autor da solicitação pull, bem como para todos os revisores obrigatórios ou opcionais da solicitação pull.

dica

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

As solicitações pull exigem duas ramificações em um repositório de origem: uma ramificação de origem que contém o código que você deseja revisar e uma ramificação de destino, onde você deseja mesclar o código revisado. A ramificação de origem contém a confirmação AFTER, que é a confirmação que contém as alterações que você deseja mesclar na ramificação de destino. A ramificação de destino contém a confirmação BEFORE, que representa o estado do código (antes de a ramificação da solicitação pull ser mesclada à ramificação de destino).

nota

Enquanto você cria uma solicitação pull, a diferença exibida é a diferença entre a ponta da ramificação de origem e a ponta da ramificação de destino. Depois de criar a solicitação pull, a diferença exibida será entre a revisão da solicitação pull escolhida e a confirmação que foi a ponta da ramificação de destino quando você criou a solicitação pull. Para ter mais informações sobre diferenças e bases de mesclagem no Git, consulte git-merge-base na documentação do Git.

Enquanto uma solicitação pull é criada para um repositório de origem e ramificações específicas, você pode criá-las, visualizá-las, revisá-las e fechá-las como parte do trabalho com seu projeto. Você não precisa visualizar o repositório de origem para visualizar e trabalhar com solicitações pull. Um estado de solicitação pull é definido como Aberto ao criá-lo. A solicitação pull permanece aberta até que você a mescle no console do CodeCatalyst, o que altera o estado para Mesclado, ou a feche, o que altera o estado para Fechado.

Quando seu código for revisado, você poderá alterar o estado da solicitação pull de várias maneiras:

  • Mescle a solicitação pull no console do CodeCatalyst. O código na ramificação de origem da solicitação pull será mesclado na ramificação de destino. O status da solicitação pull mudará para Mesclado. Ele não pode ser alterado de volta para Aberto.

  • Mescle as ramificações localmente, envie suas alterações e, depois, feche a solicitação pull no console do CodeCatalyst.

  • Use o console do CodeCatalyst para fechar a solicitação pull sem mesclar. Isso mudará o status para Fechado e não mesclará o código da ramificação de origem com a ramificação de destino.

Antes de criar uma solicitação pull:

  • Confirme e envie as alterações de código que você deseja revisar para uma ramificação (a ramificação de origem).

  • Configure notificações para seu projeto para que outros usuários possam ser notificados sobre quaisquer fluxos de trabalho executados quando você cria uma solicitação pull. (Esta etapa é opcional, mas recomendada.)

Tópicos