GitHub App und Berechtigungen
HeyDeer arbeitet über eine GitHub App, die in Ihrem persönlichen Konto oder Ihrer Organisation installiert ist. Die Installation bestimmt, welche Repositorys HeyDeer lesen und prüfen kann.
HeyDeer installieren
Jeder Arbeitsbereich gehört zu einem GitHub-Konto. Bei der Einrichtung werden Sie zu GitHub weitergeleitet, um die App zu installieren; in einer Organisation kann das nur ein Inhaber.
Andernfalls sendet GitHub den Inhabern eine Anfrage. Solange sie aussteht, zeigt HeyDeer „Warten auf die Genehmigung eines GitHub-Inhabers“, und Admins können den Arbeitsbereich bereits konfigurieren. Sobald ein Inhaber zustimmt, verbindet sich der Arbeitsbereich automatisch, und HeyDeer sendet eine E-Mail an die Benachrichtigungsadresse. Wenn Sie die Anfrage über „GitHub-Organisation hinzufügen“ gestellt haben, richtet HeyDeer den Arbeitsbereich der Organisation mit Ihnen als Admin ein.
Repositories auswählen
Wählen Sie „Only select repositories“ und die zu prüfenden Repositorys; „All repositories“ schließt auch später erstellte Repositorys ein. Um die Auswahl zu ändern, öffnen Sie Organisationseinstellungen → GitHub-Verbindung und wählen „GitHub-Zugriff verwalten“. Nur ein GitHub-Inhaber des Kontos kann dort Änderungen speichern.
Hinzugefügte Repositorys folgen den Prüfregeln der Organisation. Eine Person sieht ein Repository und seine Prüfungen in HeyDeer, wenn sowohl sie als auch die Installation auf GitHub darauf zugreifen können; zum Anfordern einer Prüfung ist Schreibzugriff nötig. Siehe Befehle in PR-Kommentaren.
Organisation fehlt? Wählen Sie „GitHub-Organisation hinzufügen“. Bei einer Organisation mit SSO melden Sie sich zuerst auf GitHub über SSO an und wählen dann „GitHub erneut autorisieren“.
Berechtigungen
| Berechtigung | Zugriff | Wofür HeyDeer sie nutzt |
|---|---|---|
| Contents | Lesen und schreiben | Code und Verlauf lesen. GitHub verlangt Schreibzugriff, um Review-Threads aufzulösen; HeyDeer nutzt ihn nur für seine eigenen Threads. |
| Pull requests | Lesen und schreiben | Pull Requests lesen und Prüfungen, Kommentare und Antworten veröffentlichen. |
| Checks | Lesen und schreiben | Den Check HeyDeer Review anzeigen und Anfragen über seine Schaltflächen empfangen. |
| Issues | Lesen | Befehle in PR-Kommentaren empfangen und verknüpfte Issues lesen. |
| Metadata | Lesen | Grundlegende Repository-Informationen lesen und ermitteln, wer Schreibzugriff hat. |
| Members (Organisation) | Lesen | Mitglieder des Arbeitsbereichs auflisten und Mitglieder- und Teamregeln abgleichen. |
| Email addresses (Konto) | Lesen | Ihre bestätigte E-Mail-Adresse als Benachrichtigungsadresse vorschlagen. |
Wenn HeyDeer eine Berechtigung benötigt, die die Installation nicht gewährt hat, zeigt Organisationseinstellungen → GitHub-Verbindung „GitHub-Berechtigung erforderlich“. Wählen Sie „Berechtigungsanfrage prüfen“, damit ein Inhaber sie auf GitHub annehmen kann.