Ferndesk
Linear-Integration

So nutzen Sie Fern in Linear-Issues

Sobald Sie Linear mit Ferndesk verbunden haben, können Sie direkt aus Ihren Linear-Issues heraus mit Fern arbeiten.

Dies ermöglicht es Ihnen, Dokumentationsaufgaben zu erstellen, ohne zwischen den Tools wechseln zu müssen. @erwähnen oder weisen Sie Issues einfach Fern zu und beobachten Sie, wie Aufgaben in Ihrem Ferndesk-Konto erstellt und ausgeführt werden.

Dieser Leitfaden setzt voraus, dass Sie Ihr Linear-Konto bereits mit Ferndesk verbunden haben.

So funktioniert es

Voraussetzungen

  • Linear-Workspace, der über die Integrations-Seite mit Ferndesk verbunden ist

  • Zugriff auf den Linear-Workspace, in dem die Ferndesk-App installiert ist

Wenn Sie Ihr Linear-Konto vor dem 15. September verbunden haben, müssen Sie die Linear-App möglicherweise neu installieren.

So @erwähnen Sie Fern in Linear-Issues

Der schnellste Weg, Fern an einer Dokumentationsaufgabe arbeiten zu lassen, besteht darin, Fern direkt in einem Linear-Issue zu @erwähnen.

  1. Öffnen Sie ein bestehendes Linear-Issue oder erstellen Sie ein neues in Ihrem verbundenen Workspace.

  2. Geben Sie in der Issue-Beschreibung oder in Kommentaren @Fern gefolgt von Ihrer Anfrage ein.

    Beispiel: "@Fern dokumentiere diesen neuen API-Endpunkt für Entwickler"

    Fern erscheint als erwähnbarer Benutzer im Autovervollständigungs-Dropdown.

  3. Vervollständigen Sie Ihre Nachricht mit klaren Anweisungen darüber, welche Dokumentation Sie benötigen.

    Beispielanfragen:

    • "@Fern erstelle einen Hilfeartikel, der erklärt, wie diese Integration eingerichtet wird"

    • "@Fern aktualisiere den bestehenden Artikel über Benutzerberechtigungen, um diese neue Rolle aufzunehmen"

    • "@Fern schreibe Schritte zur Fehlerbehebung für diese Fehlermeldung"

  4. Senden Sie Ihren Kommentar ab

    In wenigen Sekunden wird Fern antworten und Sie wissen lassen, dass sie mit der Arbeit an der Aufgabe begonnen hat.

  5. Verfolgen Sie die Fortschrittsaktualisierungen in Linear, während Fern arbeitet.

    Was Sie sehen werden: Thread-Aktivitäten, die Ferns Überlegungen zeigen

Wenn Fern die Aufgabe abgeschlossen hat, erhalten Sie eine Benachrichtigung von Fern mit einem Link, um die Ergebnisse in Ferndesk anzusehen. Klicken Sie auf diesen Link, um die Dokumentation zu überprüfen und zu veröffentlichen.

Für beste Ergebnisse geben Sie in Ihren Linear-Issues klaren Kontext an, bevor Sie Fern @erwähnen. Der Issue-Titel, die Beschreibung und die Kommentare werden alle Teil des Kontexts, den Fern zur Erstellung der Dokumentation verwendet.

So weisen Sie Linear-Issues Fern zu

Alternativ können Sie ein gesamtes Linear-Issue Fern zuweisen, was automatisch eine Dokumentationsaufgabe basierend auf dem vollständigen Issue-Kontext auslöst.

  1. Öffnen Sie das Linear-Issue, an dem Fern arbeiten soll.

  2. Klicken Sie auf das Feld Beauftragter (Assignee) im Issue-Header.

    Erwartetes Ergebnis: Ein Dropdown-Menü erscheint, das Teammitglieder und Integrationen anzeigt.

  3. Suchen Sie im Dropdown-Menü nach Fern und wählen Sie es aus.

    Erwartetes Ergebnis: Fern wird als Beauftragter hinzugefügt, und Fern antwortet sofort im Issue-Thread.

  4. Fern wird das gesamte Issue (Titel, Beschreibung und Kommentare) als Kontext für die Erstellung der Dokumentationsaufgabe verarbeiten.

    Im Hintergrund wird automatisch eine neue Aufgabe in Ihrem Ferndesk-Konto unter ferndesk.com/app/tasks erstellt.

Folgeanfragen stellen

Sie können die Konversation mit Fern direkt im Linear-Issue-Thread fortsetzen, um die Dokumentation zu verfeinern.

  1. Fügen Sie einen neuen Kommentar im selben Linear-Issue hinzu, in dem Fern arbeitet.

  2. @erwähnen Sie @Fern erneut mit Ihrer Folgeanfrage.

  3. Fern nimmt die Arbeit an der bestehenden Ferndesk-Aufgabe wieder auf und wendet Ihre gewünschten Änderungen an.

Folgeanfragen müssen im selben Linear-Issue-Thread gepostet werden. Das Erstellen eines neuen Issues startet eine völlig neue Ferndesk-Aufgabe.

Überprüfen und Veröffentlichen in Ferndesk

Nachdem Fern die Arbeit in Linear abgeschlossen hat, überprüfen und veröffentlichen Sie die Dokumentation in Ihrem Ferndesk-Konto.

  1. Klicken Sie auf den Ferndesk-Link in Ferns Abschlussnachricht in Linear oder navigieren Sie zu ferndesk.com/app/tasks.

  2. Öffnen Sie die Aufgabe, um Ferns Arbeit zu überprüfen.

  3. Überprüfen Sie den Entwurf des Inhalts auf Richtigkeit und Vollständigkeit.

  4. Klicken Sie auf Veröffentlichen, um den Artikel zu Ihrem Hilfe-Center hinzuzufügen, oder nehmen Sie bei Bedarf weitere Änderungen vor.

Wie geht es weiter?

War das hilfreich?