Treinamento
Módulo
Colaborar com solicitações de pull no Azure Repos - Training
Colaborar com solicitações de pull no Azure Repos
Não há mais suporte para esse navegador.
Atualize o Microsoft Edge para aproveitar os recursos, o suporte técnico e as atualizações de segurança mais recentes.
Alguns repositórios, incluindo os repositórios do .NET, não têm o web hook "PR Merger" habilitado, que mescla automaticamente as PRs secundárias. Este artigo descreve o processo de revisão de PR para esses repositórios. O processo de revisão de PR foi criado com estas metas:
Os processos continuam a evoluir conforme as equipes inovam e a plataforma amadurece.
Um dos membros da equipe de conteúdo examina cada PR. Os membros da equipe de conteúdo podem solicitar uma revisão de membros específicos da equipe de produto para verificar a exatidão técnica. A equipe de conteúdo usa recursos de propriedade de código do GitHub para solicitar automaticamente revisões de membros da equipe de conteúdo. Como parte desse processo, um revisor pode marcar outros membros da equipe para revisar PRs internos. Os membros da equipe veem as revisões solicitadas de membros da equipe e membros da comunidade na mesma fila.
Membros da comunidade podem revisar PRs e fazer comentários. No entanto, pelo menos um membro da equipe de conteúdo principal deve aprovar qualquer PR antes da mesclagem.
As revisões seguem um dos três caminhos com base no PR:
O processamento usado pelo bot de CLA (Contrato de Licença do Colaborador) é uma boa diretriz para a distinção entre contribuições "pequenas" e "grandes". PRs que não exigem que o CLA seja assinado provavelmente são "pequenos". PRs que exigem o CLA provavelmente são "grandes".
As alterações em PRs pequenas são examinadas para fins de precisão e verificadas usando o build do site de análise. Como são pequenos, esses PRs não disparam uma revisão do artigo inteiro.
Os revisores podem notar outras pequenas alterações que melhorariam um artigo. Se essas alterações também forem pequenas, sugira-as em comentários. Se as alterações sugeridas dispararem uma revisão maior, abra um problema e resolva-o mais tarde.
PRs maiores passam por uma revisão mais completa. Tudo isto é verificado:
Os membros da equipe de conteúdo examinarão a PR e enviarão a revisão com comentários. Se somente pequenas alterações forem solicitadas, os membros da equipe "aprovam" o PR com os comentários. O autor pode resolver os comentários e mesclar o PR. A maioria das revisões solicita alterações e, quando essas alterações são feitas, o revisor faz outra revisão.
Se as edições exigirem uma revisão técnica, o revisor da equipe de conteúdo solicitará uma revisão do membro da equipe de produto apropriado.
Talvez você queira receber feedback antecipado no processo. Abra uma PR de rascunho e adicione um comentário solicitando uma análise antecipada. Essas revisões antecipadas enfocam a estrutura do artigo: a estrutura de tópicos, o conteúdo geral e os exemplos. Elas não incluem uma verificação completa de gramática e links corretos.
O GitHub permite que você insira comentários em blocos de acentos graves triplos do tipo suggestion
, os quais são exibidos como uma comparação e podem ser mesclados clicando em um botão. Em linhas curtas, o GitHub faz um bom trabalho ao realçar as alterações. Em linhas mais longas, como um parágrafo longo em uma linha de texto, o GitHub não realça as alterações. Ao inserir uma sugestão para uma linha longa, observe se as suas alterações estão claramente realçadas. Se as alterações não estiverem realçadas, inclua comentários fora do bloco de sugestões explicando o que você alterou. Sem uma explicação, muitas vezes é demorado para os revisores subsequentes ou o criador da PR descobrir quais são as alterações.
O autor atualiza a PR para responder aos comentários. Se o autor não concordar com o comentário ou abordar o comentário em uma PR diferente, ele adicionará um comentário explicando a alteração.
O autor faz uma menção com @ ao revisor original em um comentário para solicitar uma nova revisão.
Geralmente, os membros da equipe de conteúdo revisam PRs novo em dois dias úteis.
Depois que uma revisão for enviada, os autores devem tentar responder aos comentários em uma semana ou menos. Os voluntários podem não conseguir atender a essas expectativas devido a outros compromissos. Nesses casos, os membros da equipe perguntarão se o autor da comunidade atualizará o PR. Caso contrário, o membro da equipe atualizará e mesclará o PR para ele.
Treinamento
Módulo
Colaborar com solicitações de pull no Azure Repos - Training
Colaborar com solicitações de pull no Azure Repos