App do GitHub e permissões
O HeyDeer funciona por meio de um GitHub App instalado na sua conta pessoal ou organização. A instalação define quais repositórios o HeyDeer pode ler e revisar.
Instalar o HeyDeer
Cada espaço de trabalho pertence a uma conta do GitHub. Ao configurar um, você é levado ao GitHub para instalar o app, o que, em uma organização, só um proprietário pode fazer.
Caso contrário, o GitHub envia uma solicitação aos proprietários. Enquanto ela estiver pendente, o HeyDeer mostra Aguardando a aprovação de um proprietário do GitHub, e os administradores já podem configurar o espaço de trabalho. Quando um proprietário aprova, o espaço de trabalho se conecta sozinho e o HeyDeer envia um e-mail ao endereço de notificação. Se você fez a solicitação em Adicionar uma organização do GitHub, o HeyDeer configura o espaço de trabalho da organização com você como administrador.
Escolher repositórios
Escolha Only select repositories e selecione os repositórios a revisar; All repositories também inclui repositórios criados depois. Para mudar a seleção, abra Configurações da organização → Conexão com o GitHub e selecione Gerenciar acesso ao GitHub. Apenas um proprietário da conta no GitHub pode salvar alterações ali.
Os repositórios adicionados seguem as regras de revisão da organização. Uma pessoa vê um repositório e as revisões dele no HeyDeer quando tanto ela quanto a instalação têm acesso a ele no GitHub; solicitar uma revisão exige acesso de escrita. Consulte Comandos em comentários do PR.
A organização não aparece? Selecione Adicionar uma organização do GitHub. Para uma organização que usa SSO, entre primeiro pelo SSO no GitHub e depois selecione Autorizar GitHub novamente.
Permissões
| Permissão | Acesso | Para que o HeyDeer a usa |
|---|---|---|
| Contents | Leitura e escrita | Ler o código e o histórico. O GitHub exige acesso de escrita para resolver conversas de revisão; o HeyDeer o usa apenas nas próprias conversas. |
| Pull requests | Leitura e escrita | Ler pull requests e publicar revisões, comentários e respostas. |
| Checks | Leitura e escrita | Mostrar a verificação HeyDeer Review e receber as solicitações feitas pelos botões dela. |
| Issues | Leitura | Receber comandos em comentários do PR e ler issues vinculadas. |
| Metadata | Leitura | Ler informações básicas do repositório e quem tem acesso de escrita. |
| Members (organização) | Leitura | Listar os membros do espaço de trabalho e aplicar regras de membros e equipes. |
| Email addresses (conta) | Leitura | Sugerir seu e-mail verificado como endereço de notificação. |
Se o HeyDeer precisar de uma permissão que a instalação não concedeu, Configurações da organização → Conexão com o GitHub mostra Permissão do GitHub necessária. Selecione Revisar solicitação de permissão para que um proprietário possa aceitá-la no GitHub.