Processar um 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, pode ser necessário passar por um ou mais processos de validação de RP. Depois de selecionar Criar solicitação pull, o GitHub executa as validações configuradas para seu repositório. Quando o processo de validação termina, os resultados aparecem no PR.

Os processos de validação variam consoante o âmbito das alterações propostas e as regras do repositório de destino. Depois de enviar seu RP, você pode esperar que uma ou mais das seguintes situações aconteçam:

• Capacidade de mesclagem: um teste de mesclabilidade do GitHub de linha de base ocorre primeiro para verificar se as alterações propostas em sua ramificação entram em conflito com a ramificação de destino. Se a RP indicar que esse 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 um colaborador que não é da Microsoft, se você estiver contribuindo para um repositório público, poderá ser solicitado que você conclua um breve CLA na primeira vez que enviar um PR para esse repositório. Depois que a etapa do CLA for limpa, seu PR será processado.
• Rotulagem: as etiquetas são aplicadas automaticamente ao seu PR para indicar o estado do seu PR à medida que passa pelo fluxo de trabalho de validação. Por exemplo, novos RPs podem receber automaticamente o rótulo "não mesclar", indicando que o RP ainda não concluiu as etapas de validação, revisão e aprovação.
• Validação e compilação: as suas alterações são examinadas por verificações automatizadas para determinar se passam nos testes de validação. Os testes de validação podem gerar avisos ou erros, exigindo que você edite um ou mais arquivos em seu PR antes que ele possa ser mesclado. Os resultados do teste de validação são adicionados como um comentário em seu RP para sua revisão, e eles podem ser enviados para você por e-mail.
• Preparo: Após a validação e a compilação bem-sucedidas, os artigos alterados são automaticamente implantados em um ambiente de preparo para revisão. Os URLs de Pré-visualização são disponibilizados num comentário de PR.
• Mesclagem automática: o PR pode ser mesclado automaticamente se passar no teste de validação e em determinados critérios. Neste caso, você não precisa fazer mais nada.

Revise e resolva o feedback

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 assinar a mesclagem. Poderá ter de alterar o seu conteúdo por qualquer uma das seguintes razões:

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

Se precisar de fazer alterações, pode editar o seu conteúdo diretamente no PR ou pode voltar ao VS Code para efetuar as alterações. Quando terminar, confirme as alterações na ramificação de trabalho. O PR é atualizado automaticamente com as 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 executa novamente 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 assinar seu RP 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 avaliações e verificações de validação sejam aprovadas, você é responsável por usar esse comentário para informar aos revisores de RP e aos administradores de repositórios que suas alterações estão prontas para mesclagem.

Quando os revisores determinam que sua RP está livre de problemas e assinada, suas alterações são mescladas na ramificação padrão e a RP é fechada.

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 de nível de gravação atribuindo o rótulo apropriado a um RP. Se você estiver trabalhando em um repositório onde a automação de comentários foi implementada, use os comentários de hashtag listados na tabela a seguir para atribuir rótulos, alterar rótulos ou fechar uma RP. Os autores da Microsoft também serão notificados por e-mail para revisão e aprovação sempre que forem propostas alterações aos seus artigos.

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

Em publicação

Sua RP deve ser mesclada 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 RP são revistas e fundidas por ordem de apresentação.

Depois que suas contribuições são aprovadas e mescladas, o processo de publicação as retoma. Dependendo da equipe que gerencia o repositório para o qual você está contribuindo, os tempos de publicação podem variar, mas normalmente ocorrem pelo menos uma vez todos os dias da semana. Os artigos poderão demorar até 45 minutos a aparecer online após a publicação.

Assim que as alterações forem publicadas, elas serão ativadas no Microsoft Learn para que outras pessoas comecem a aprender!

Próximos passos

Está feito! Você fez uma contribuição para o conteúdo do Microsoft Learn!