PR Inbox

O que é o PR Inbox?

O PR Inbox reúne pull requests que precisam de revisão, trabalho aguardando o autor e PRs mesclados ou fechados recentemente. Use-o para escolher o que revisar em seguida e acompanhar a sequência de revisões do squad.

A sequência de revisões mede o tempo de espera por um revisor durante o expediente configurado. Ela é diferente da sequência baseada no tempo até o merge por repositório descrita em Open PRs.

Abra sua Caixa de Entrada

  1. Abra PR Inbox na navegação do produto.
  2. Selecione um squad e, se necessário, restrinja a lista a repositórios específicos.
  3. Escolha Me para os PRs que você criou ou dos quais participa, ou Squad para o escopo de repositórios da equipe selecionada.
  4. Se solicitado, selecione seu player para que o DevStats associe sua identidade no provedor às visualizações pessoais. Você pode gerenciar essa associação na página PR Inbox do seu perfil.

Seletor de player do PR Inbox com Which player are you e botões This is me

Sem uma integração com um provedor Git, o relatório mostra dados de exemplo. Conecte seus repositórios para trabalhar com seus próprios pull requests.

PR Inbox com visualizações Me e Squad, filtros, sequência de revisões e fila Review next

Escolha o que Revisar

A aba Open agrupa os PRs pelo estado atual:

Seção Como usar
Review next Comece pela fila sugerida, ordenada pela proximidade do limite de revisão e, depois, pelo tamanho. Em Me, seus próprios PRs não entram nessa fila.
Waiting for review Revise os PRs cujo relógio de revisão está contando, começando pelos mais urgentes.
Other open PRs Confira o trabalho que aguarda o autor ou um merge, do mais antigo para o mais recente.
Drafts Expanda a seção para ver os PRs que ainda não estão prontos para revisão.

As linhas mostram o status e os tempos de revisão junto aos detalhes do PR. Os minutos estimados de revisão vêm das faixas de tamanho configuradas e da quantidade de linhas alteradas; são estimativas, não uma duração de revisão medida.

Filtre a Lista

Use a navegação lateral para restringir a visualização selecionada:

  • My inbox / Our team: a lista principal de Me / Squad.
  • My PRs: PRs que você criou.
  • Participating: PRs de outros autores nos quais você foi solicitado como revisor ou já realizou uma revisão.
  • From others: PRs que você não criou e dos quais não participa; disponível em Squad.
  • Bots: PRs de autores identificados como bots.
  • >3 days old: PRs criados há mais de três dias.
  • >24h stale: PRs sem atualização há mais de 24 horas, usando a data de criação quando não há data de atualização.
  • Unlinked to issue: PRs sem um vínculo de issue identificado.
  • Excluded: PRs excluídos individualmente, quando a exclusão está habilitada.

Os filtros pessoais exigem uma associação de player. Os filtros de idade e de ausência de atualização usam tempo decorrido; eles são separados do relógio de expediente da sequência de revisões.

Inspecione um Pull Request

Abra o painel de detalhes de um PR para ver seu status, branches de origem e destino, divisão do tempo em aberto, autor, revisores, issues vinculadas, tamanho da alteração e linha do tempo. Use Open in provider para continuar a revisão no provedor Git.

Detalhes do pull request com tempo de espera, informações, linha do tempo e link do provedor

Quando a exclusão estiver disponível, Exclude from inbox retira um PR individual da seleção normal da caixa de entrada. Encontre-o em Excluded e use Restore to inbox para incluí-lo novamente. Essas ações não fecham nem fazem o merge do PR no provedor.

Acompanhe a Sequência de Revisões

O squad mantém sua sequência quando nenhum PR elegível espera por um revisor além do limite configurado nos dias de trabalho. O tempo com o autor não conta como espera por revisão.

O cartão mostra a sequência atual, o status de hoje, a maior sequência e o resultado do trimestre. Expanda o calendário e selecione um dia marcado como interrompido para inspecionar os PRs responsáveis. Dias de folga não contam a favor nem contra a sequência.

Calendário da sequência de revisões com resultados diários e maior sequência

Dia de sequência interrompida mostrando os pull requests em espera e seu status em relação ao limite de revisão

Um PR pode continuar aberto enquanto aguarda o autor ou um merge; por isso, o tempo total em aberto pode ser diferente do tempo de espera por revisão.

Configure o PR Inbox

Abra a engrenagem PR Inbox settings se você tiver permissão para visualizar as configurações do workspace.

Sequência de Revisões e Inclusão

  • Defina o tempo máximo de espera por revisão: 8, 24, 48 ou 72 horas. O padrão é 24 horas, aplicado a todos os repositórios.
  • Defina o expediente e os dias de trabalho. O relógio usa o fuso horário do workspace.

Limite de revisão, expediente, dias de trabalho e fuso horário do workspace

  • Revise What counts para configurar o tratamento de drafts e bots, os nomes das contas de bots e a possibilidade de excluir PRs individualmente.

Configurações de drafts, autores bots e exclusão individual

  • Ajuste as faixas de tamanho de Review next às estimativas de esforço de revisão da equipe.

Faixas de tamanho dos PRs e minutos estimados de revisão

Quando uma alteração afeta os cálculos da sequência, o fluxo de salvamento solicita o recálculo do histórico. Ele ocorre em segundo plano com os dados existentes; não busca novos dados nos provedores. A sequência, a maior sequência e o resultado do trimestre podem mudar durante o recálculo.

Alertas e Canais dos Squads

Conecte um canal em Workspace Settings → Channels. Em seguida, configure a forma de entrega e um destino para pelo menos um squad em Squad channels e salve.

Canais de entrega, destinos e horários de revisão dos squads

Quando um squad tem um canal, os controles de alertas são liberados. Configure Daily review window para uma fila sugerida de revisão e Streak kept or broken para o resultado ao final do dia. Squads sem canal não recebem alertas.

Configurações dos alertas da janela diária de revisão e do resultado da sequência

Consulte o Histórico Recente

Abra Merged para ver os PRs mesclados nos últimos 30 dias, ou Closed para os PRs fechados sem merge nos últimos 30 dias. Use a busca e os controles de ordenação do histórico para encontrar trabalho concluído.

Pull requests mesclados recentemente com busca e colunas ordenáveis

Atualize os Dados

O relatório se atualiza automaticamente conforme novos dados ficam disponíveis. Use Sync quando alterações recentes do provedor não aparecerem e acompanhe o progresso mostrado no relatório. A sincronização pode levar algum tempo; iniciá-la não significa que todos os dados dos PRs serão atualizados imediatamente.