Melde dich in Ferndesk als Inhaber oder Administrator in dem Workspace an, in dem du die Verbindung eingerichtet hast. Wenn du in einem anderen Tab den Workspace gewechselt hast, wechsle zurück und stelle die Verbindung erneut her.
GitHub verbinden
Verbinde GitHub, damit Fern deinen Code und gemergte Pull Requests lesen kann. Fern nutzt sie, um präzise Artikel zu verfassen, Updates zu entwerfen, wenn du etwas veröffentlichst, und API-Referenzen zu aktualisieren, wenn sich der Code ändert. Fern liest deinen Code nur.
Inhaber und Administratoren können GitHub verbinden und auswählen, welche Repositories Fern verwendet.
Ferndesk-App installieren
Gehe zunächst zu Integrationen und installiere dann die Ferndesk-App auf GitHub. Wähle anschließend die Repositories aus, auf die sie zugreifen darf. Eine Installation kann ein Produkt abdecken, das auf mehrere Repositories verteilt ist, zum Beispiel ein Backend und ein Dashboard.
Wenn du in deiner GitHub-Organisation keine Apps installieren kannst, sendet GitHub eine Installationsanfrage an die Inhaber. Sobald diese sie genehmigt haben, wähle erneut Verbinden, um den Vorgang abzuschließen. Wenn du dich nur anmeldest, ohne die App zu installieren, kann Fern keine Entwürfe aus gemergten Pull Requests erstellen.
Verwendest du mehrere Ferndesk-Workspaces mit einer GitHub-Installation? Wähle GitHub-Verbindung wiederverwenden, anstatt die Autorisierung erneut durchzuführen. Du musst Inhaber oder Administrator des Workspace sein, aus dem die Verbindung stammt. Die Repositories sind im neuen Workspace zunächst deaktiviert.
Repositories für Fern auswählen
Für jedes Repository, das die Installation freigibt, gibt es einen Schalter, mit dem festgelegt wird, ob Fern es für die Dokumentation verwendet. Neue Repositories sind standardmäßig aktiviert.
Wenn du ein Repository deaktivierst, wird es in diesem Workspace nicht für Ferns Code-Recherche und Pull-Request-Entwürfe verwendet. Die GitHub-App kann weiterhin darauf zugreifen.
Um mehr oder weniger Repositories freizugeben, wähle im Menü der Verbindung Repositories auf GitHub ändern.
Mit Support liest Fern jedes freigegebene Repository, wenn Fern eine Unterhaltung mit einem Kunden untersucht – unabhängig von der Schalterstellung.
Produktionsbranch festlegen
Der Produktionsbranch ist der Branch, den deine Kunden verwenden. Ein Pull Request gilt als veröffentlicht, wenn er in diesen Branch gemergt wird. Darauf reagieren Entwürfe aus gemergten Pull Requests. Jedes Repository verwendet zunächst seinen Standardbranch, bis du in der Spalte Produktionsbranch einen anderen auswählst. Wenn dieser Branch nicht mehr auf GitHub vorhanden ist, wird das Repository mit einem Hinweis an den Anfang der Liste verschoben. Wurde der Branch gelöscht, verwendet Fern wieder den Standardbranch. Wurde er umbenannt, wähle den neuen Namen unter Produktionsbranch aus.
Fehlerbehebung
Verbindung kann aufgrund eines Anmelde- oder Workspace-Fehlers nicht hergestellt werden
Verbindung kann nach der Autorisierung aufgrund eines Zugriffsfehlers nicht hergestellt werden
Das verwendete GitHub-Konto kann die Ferndesk-App-Installation nicht sehen. Bitte einen Inhaber oder Administrator dieser GitHub-Organisation, die Verbindung herzustellen.
Fern erstellt keine Entwürfe aus gemergten Pull Requests
Prüfe, ob das Repository aktiviert ist, ob sein Produktionsbranch der Branch ist, in den du mergst, und ob Entwürfe aus gemergten PRs unter Fern > Anpassen > Automatisierungen aktiviert ist. Für Entwürfe muss die GitHub-App installiert sein. Eine GitHub-Anmeldung allein reicht nicht aus.