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
- Abra PR Inbox na navegação do produto.
- Selecione um squad e, se necessário, restrinja a lista a repositórios específicos.
- Escolha Me para os PRs que você criou ou dos quais participa, ou Squad para o escopo de repositórios da equipe selecionada.
- 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.
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.
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.
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.
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.
- Revise What counts para configurar o tratamento de drafts e bots, os nomes das contas de bots e a possibilidade de excluir PRs individualmente.
- Ajuste as faixas de tamanho de Review next às estimativas de esforço de revisão da equipe.
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.
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.
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.
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.