Ferndesk
Audits und Automatisierung

Automatische PR-Entwürfe

Automatische PR-Entwürfe halten deine Dokumentation mit deinem Produkt synchron. Wenn ein zusammengeführter Pull Request das kundenrelevante Verhalten ändert, erkennt Fern das und erstellt automatisch einen Entwurf für ein Doku-Update.

Diese Funktion verbindet deine GitHub-Integration mit Fern, sodass Dokumentationsaktualisierungen ohne manuelle Überwachung erfolgen. Du prüfst und genehmigst weiterhin jeden Entwurf, bevor er live geht.

So funktioniert es

Wenn du automatische PR-Entwürfe aktivierst, überwacht Fern zusammengeführte Pull Requests in deinen verbundenen GitHub-Repositories. Wenn ein Merge etwas ändert, das deine Kunden wissen müssen, erstellt Fern automatisch einen Entwurf für einen Artikel oder ein Update.

Der Entwurf erscheint auf deiner Fern-Seite als Thread mit einem Pull-Request-Symbol. Du prüfst ihn, nimmst bei Bedarf Änderungen vor und veröffentlichst ihn, wenn du bereit bist. Fern veröffentlicht nie automatisch.

Wenn du mehrere Repositories verbunden hast, kann Fern seine Analyse auf das Repository beschränken, in dem der Merge erfolgt ist. Bei branchspezifischen Änderungen kann Fern außerdem den betreffenden Branch durchsuchen, um zu verstehen, was sich geändert hat, bevor das Update entworfen wird.

Voraussetzungen

  • GitHub-Integration verbunden - Fern benötigt Zugriff auf deine Repositories, um Pull Requests zu überwachen. Wenn du GitHub noch nicht verbunden hast, richte zuerst die Integration ein.

Automatische PR-Entwürfe aktivieren

1

Go to Settings

Öffne die Einstellungen über die Seitenleiste in deinem Ferndesk-Dashboard.

2

Open Automations

Klicke in der Einstellungs-Seitenleiste auf Automatisierungen. Auf dieser Seite werden sowohl automatische PR-Entwürfe als auch geplante Audit-Einstellungen angezeigt.

3

Enable the toggle

Schalte Automatische PR-Entwürfe ein. Die Einstellung wird sofort gespeichert und du siehst eine Bestätigungs-Toast-Meldung.

Sobald aktiviert, beginnt Fern mit der Überwachung zusammengeführter Pull Requests auf kundenrelevante Änderungen.

Was löst einen Entwurf aus

Fern erstellt einen Entwurf, wenn:

  • Ein Pull Request in einem deiner verbundenen GitHub-Repositories zusammengeführt wird

  • Der Merge Änderungen an kundenrelevantem Verhalten enthält (UI-Abläufe, API-Endpunkte, Funktionsverhalten, Fehlermeldungen oder Konfigurationsoptionen)

Fern analysiert den Diff, um zu bestimmen, ob die Dokumentation aktualisiert werden muss. Wenn die Änderung intern ist oder Kunden nicht betrifft, markiert Fern den Thread als „Keine Dokumentationsänderungen erforderlich“ und erstellt keinen Entwurf.

Du kannst Runs sehen, bei denen Fern keine Entwürfe erstellt hat, indem du auf der Fern-Seite nach Automatisierungen filterst.

Entwürfe prüfen

Wenn Fern einen Entwurf erstellt, erscheint er auf deiner Fern-Seite als Thread mit einem Pull-Request-Symbol. Der Thread zeigt:

  • Den PR-Titel und die Metadaten

  • Eine Zusammenfassung der Änderungen

  • Den Entwurfsstatus (in Bearbeitung, bereit zur Prüfung oder Fehler)

Klicke auf den Thread, um das Detailbereich zu öffnen. Wenn der Entwurf fertig ist, klicke auf Änderungen prüfen & bearbeiten, um zu sehen, was Fern geschrieben hat. Bearbeite den Entwurf direkt, fordere Änderungen an, indem du Fern im Thread eine Nachricht schickst, oder veröffentliche ihn, wenn du zufrieden bist.

Du kannst die Thread-Liste von Fern filtern, indem du Hat Entwürfe auswählst, um nur Threads mit bereit zur Prüfung stehenden Entwurfsaktualisierungen zu sehen.

Du kontrollierst die Veröffentlichung

Fern erstellt Entwürfe für Aktualisierungen, veröffentlicht sie aber nie automatisch. Jeder Entwurf erfordert deine Prüfung und Genehmigung, bevor er in deinem Hilfe-Center erscheint. So behältst du die volle Kontrolle darüber, was live geht, und sparst dir gleichzeitig die manuelle Arbeit, Pull Requests zu überwachen.

Verwandte Artikel

War das hilfreich?