GitHub App y permisos
HeyDeer funciona mediante una GitHub App instalada en tu cuenta personal o en tu organización. La instalación determina qué repositorios puede leer y revisar HeyDeer.
Instalar HeyDeer
Cada espacio de trabajo pertenece a una cuenta de GitHub. Al configurarlo, se te envía a GitHub para instalar la app, algo que en una organización solo puede hacer un propietario.
Si no lo eres, GitHub envía una solicitud a los propietarios. Mientras está pendiente, HeyDeer muestra Esperando la aprobación de un propietario de GitHub, y los administradores ya pueden configurar el espacio de trabajo. Cuando un propietario la aprueba, el espacio de trabajo se conecta solo y HeyDeer envía un correo a la dirección de notificaciones. Si lo solicitaste desde Añadir una organización de GitHub, HeyDeer configura el espacio de trabajo de la organización contigo como administrador.
Elegir repositorios
Elige Only select repositories y selecciona los que quieres revisar; All repositories también añade los repositorios que se creen más adelante. Para cambiar la selección, abre Configuración de la organización → Conexión con GitHub y selecciona Gestionar acceso a GitHub. Solo un propietario de GitHub de la cuenta puede guardar cambios allí.
Los repositorios añadidos siguen las reglas de revisión de la organización. Una persona ve un repositorio y sus revisiones en HeyDeer cuando tanto ella como la instalación tienen acceso a él en GitHub; solicitar una revisión requiere acceso de escritura. Consulta Comandos en comentarios de PR.
¿Falta una organización? Selecciona Añadir una organización de GitHub. Si la organización usa SSO, inicia sesión primero mediante SSO en GitHub y luego selecciona Volver a autorizar GitHub.
Permisos
| Permiso | Acceso | Para qué lo usa HeyDeer |
|---|---|---|
| Contents | Lectura y escritura | Leer el código y el historial. GitHub exige acceso de escritura para resolver hilos de revisión; HeyDeer solo lo usa para sus propios hilos. |
| Pull requests | Lectura y escritura | Leer pull requests y publicar revisiones, comentarios y respuestas. |
| Checks | Lectura y escritura | Mostrar la comprobación HeyDeer Review y recibir las solicitudes de sus botones. |
| Issues | Lectura | Recibir comandos en comentarios de PR y leer issues vinculados. |
| Metadata | Lectura | Leer información básica del repositorio y quién tiene acceso de escritura. |
| Members (organización) | Lectura | Listar los miembros del espacio de trabajo y aplicar las reglas de miembros y equipos. |
| Email addresses (cuenta) | Lectura | Sugerir tu correo verificado como dirección de notificaciones. |
Si HeyDeer necesita un permiso que la instalación no ha concedido, Configuración de la organización → Conexión con GitHub muestra Se necesita un permiso de GitHub. Selecciona Revisar solicitud de permisos para que un propietario pueda aceptarlo en GitHub.