Nesta página

Rever pull requests no Riff

Uma pessoa da equipa alterou o cálculo da finalização da compra. Abra o pedido no Riff para ler a descrição, comparar ficheiros, discutir uma linha e decidir sobre a versão que examinou. No GitLab, estes pedidos chamam-se merge requests; o fluxo abaixo também se aplica a eles.

Abrir a versão para revisão

  1. Ligue o serviço Git com uma conta que possa aceder ao repositório e executar a ação de revisão pretendida.
  2. Abra Pull Requests no separador do repositório e escolha um pedido, ou use a ação de revisão no Riff através da Setlist.
  3. Leia a descrição, o autor, os revisores, os ramos de origem e destino e o SHA do commit revisto. Selecione um ficheiro alterado para examinar o diff.
  4. Consulte as discussões para ler os comentários existentes e as verificações para ver os resultados comunicados pelo serviço. Um resultado ausente ou parcial não é uma verificação aprovada. Abra o pedido no serviço quando o Riff indicar cobertura incompleta.

O pedido pode estar disponível enquanto o diff está indisponível. Atualize a revisão ou abra um clone no computador para o Riff preparar as revisões exatas quando necessário. Ficheiros binários, diffs muito grandes e ficheiros renomeados sem alteração de texto podem não ter linhas comentáveis.

Comentar uma linha ou responder

Use a ação de comentar linhas, selecione uma linha do diff carregado e escreva o comentário. O editor identifica o ficheiro e a linha antes do envio. Para responder, selecione uma discussão existente e escreva no respetivo editor. Os comentários são enviados ao serviço quando seleciona Enviar comentário.

A lista apresenta até 4.000 linhas e abrevia as prévias de linhas longas. Use Diff para uma comparação mais completa e a página do serviço para o conteúdo fora da vista carregada. Um estado de resolução indisponível significa que o serviço não forneceu essa informação; não significa que a discussão continua por resolver. A ligação de revisão atual do GitHub não informa esse estado.

Aprovar ou pedir alterações

Serviço Decisões disponíveis no Riff
GitHub Aprovar ou pedir alterações. Pedir alterações exige uma mensagem de revisão. O envio identifica o commit revisto.
GitLab Aprovar o commit revisto. Pedir alterações está indisponível neste fluxo integrado; deixe um comentário ou use o GitLab para outras ações de revisão.
Bitbucket Cloud Aprovar ou pedir alterações. O serviço não associa a decisão ao commit de forma atómica.
Azure DevOps Services Aprovar ou pedir alterações, representadas pelo voto do serviço que aguarda o autor. O serviço não associa o voto ao commit de forma atómica.

Confira o SHA do commit na confirmação antes de enviar. O Riff verifica novamente o pedido antes e depois do envio. Se mudou, reveja a nova versão antes de decidir de novo. As permissões e políticas de ramos do serviço continuam a aplicar-se; aprovar não faz merge do pedido.

Ler o resultado do envio

Se o Riff indicar que a ação foi enviada para uma versão anterior, o envio ocorreu, mas o pedido mudou. Se indicar que não conseguiu conferir a revisão mais recente, o envio teve sucesso, mas a verificação posterior está indisponível. Atualize antes de continuar em ambos os casos.

Se a operação não pôde ser confirmada, consulte o serviço e atualize antes de tentar novamente para evitar comentários ou votos duplicados. O Riff não repete automaticamente um envio incerto. Os rascunhos permanecem na sessão de revisão atual, e o fecho do contexto ou da janela aguarda um envio em curso.

Experimentar o código revisto

Escolha Abrir em worktree, selecione outro destino e confira o nome do ramo. O Riff prepara o commit exato da revisão e preserva a cópia original. Execute as verificações do projeto nessa pasta e volte à revisão. Contextos de trabalho e worktrees explica como alternar tarefas e remover a pasta adicional em segurança. O fluxo de revisão do Riff não exige IA.