‘Processar uma pull request

Depois de abrir uma solicitação pull (PR), a RP passa por um conjunto de verificações e revisões para garantir que as alterações propostas possam ser mescladas. Para obter mais informações sobre RPs, consulte Fundamentos do Git e do GitHub.

Validação

Antes que seu PR possa ser mesclado em sua ramificação de destino, talvez seja necessário passar por um ou mais processos de validação de PR. Depois de selecionar Criar solicitação pull, o GitHub executa as validações configuradas para seu repositório. Quando o processo de validação é concluído, os resultados aparecem no PR.

Os processos de validação variam dependendo do escopo das alterações propostas e das regras do repositório de destino. Após enviar sua PR, você pode esperar que um ou mais dos seguintes procedimentos ocorram:

• Capacidade de mesclagem: um teste de mesclagem do GitHub de linha de base ocorre primeiro para verificar se as alterações propostas em seu branch estão em conflito com o branch de destino. Se a PR indicar que o teste falhou, você deverá reconciliar o conteúdo que está causando o conflito de mesclagem antes que o processamento possa continuar.
• Contrato de Licença de Contribuição (CLA): como contribuidor que não é da Microsoft, se você estiver contribuindo com um repositório público, poderá ser solicitado que você preencha um CLA curto na primeira vez que enviar uma RP para esse repositório. Após a conclusão da etapa do CLA, sua PR será processada.
• Rotulagem: os rótulos são aplicados automaticamente à PR para indicar o estado de sua PR à medida que ela passa pelo fluxo de trabalho de validação. Por exemplo, novas PRs podem receber automaticamente o rótulo “não mesclar”, indicando que a PR ainda não concluiu as etapas de validação, revisão e aprovação.
• Validação e build: verificações automatizadas verificam se suas alterações passam pelos testes de validação. Os testes de validação podem gerar avisos ou erros, exigindo que você faça edições em um ou mais arquivos da sua PR antes que ela possa ser mesclada. Os resultados do teste de validação são adicionados como um comentário na PR para sua revisão e também podem ser enviados a você por email.
• Preparo: após validação e build bem-sucedidos, os artigos alterados são automaticamente implantados em um ambiente de preparo para revisão. As URLs de visualização aparecem em um comentário de PR.
• Mesclagem automática: O PR poderá ser mesclado automaticamente se passar no teste de validação e em determinados critérios. Nesse caso, você não precisa fazer mais nada.

Revisar e abordar comentários

Depois que todo o processamento de RP estiver concluído, você deve revisar os resultados (por exemplo, comentários de RP, resultados de compilação). Determine se você precisa fazer mais alterações antes de aprovar a mesclagem. Talvez seja necessário alterar seu conteúdo por qualquer um dos seguintes motivos:

• Comentários de RP de revisores. Se um revisor de relações públicas tiver revisado sua RP, ele poderá fornecer feedback por meio de comentários se houver problemas pendentes ou perguntas a serem resolvidas antes da mesclagem.
• Feedback dos revisores.
• Correções de formatação devido a problemas de renderização.
• Erros ou avisos de validação.
• Mesclar conflitos.

Se você precisar fazer alterações, poderá editar seu conteúdo diretamente no PR ou retornar ao VS Code para fazer as alterações. Quando terminar, confirme suas alterações em sua ramificação de trabalho. O PR é atualizado automaticamente com suas alterações.

Cada vez que você adiciona uma confirmação à mesma ramificação de trabalho, a confirmação é adicionada automaticamente à RP. A cada confirmação, o sistema de publicação reexecuta os processos de validação e revisão automaticamente.

Automação de aprovação e comentários

Quando você tiver resolvido todos os erros de feedback e validação e estiver pronto para que suas alterações sejam mescladas, é hora de aprovar seu PR criando um novo comentário que leia #sign-off. Você deve inserir o #sign-off comentário para mesclar suas alterações. Mesmo que todas as revisões e verificações de validação sejam aprovadas, você é responsável por usar esse comentário para informar aos revisores de relações públicas e administradores de repositório que suas alterações estão prontas para mesclagem.

Quando os revisores determinam que seu PR está livre de problemas e assinado, suas alterações são mescladas na ramificação padrão e o PR é fechado.

A automação de comentários permite que os usuários que não têm permissões de gravação em um repositório concluam uma ação no nível de gravação atribuindo o rótulo apropriado a um PR. Se você estiver trabalhando em um repositório no qual a automação de comentário tenha sido implementada, use os comentários da hashtag listados na tabela a seguir para atribuir rótulos, alterar rótulos ou fechar uma PR. Os autores da Microsoft também serão notificados por e-mail para revisão e aprovação sempre que forem propostas alterações em seus artigos.

Comentário da hashtag	O que faz
#sign-off	Atribui automaticamente o rótulo pronto para mesclar para permitir que os revisores no repositório saibam que a PR está pronto para revisão/mesclagem. Se você não for o autor listado e tentar assinar uma PR de repositório público usando o comentário #sign-off, a PR será atualizada para indicar que somente o autor pode atribuir o rótulo.
#hold-off	Remove o rótulo pronto para mesclar caso você mude de ideia ou cometa um erro. No repositório privado, isso atribui o rótulo do-not-merge.
#please-close	Fecha a PR se você decidir não ter as alterações mescladas.
#please-open	Reabre uma PR fechada ou um issue.

Publicação

Seu PR precisa ser mesclado por um revisor de RP antes que as alterações possam ser incluídas na próxima execução de publicação agendada. Normalmente, as PRs são revisadas e mescladas na ordem de inscrição.

Depois que suas contribuições forem aprovadas e mescladas, elas serão recolhidas pelo processo de publicação. Dependendo da equipe que gerencia o repositório para o qual você está contribuindo, os horários de publicação podem variar, mas normalmente ocorrem pelo menos uma vez por dia da semana. Pode levar até 45 minutos para que os artigos apareçam online após a publicação.

Depois que suas alterações forem publicadas, elas serão publicadas no Microsoft Learn para que outras pessoas possam começar a aprender!

Próximas etapas

É isso! Você fez uma contribuição para o conteúdo do Microsoft Learn!