Créer et modifier des articles avec Fern

Les tâches sont le moyen par lequel vous indiquez à Fern ce qu'il doit créer ou mettre à jour dans votre centre d'aide. Fern s'occupe de la recherche et de la rédaction, vous fournissez les instructions et examinez les résultats.

Créer une tâche

1

Open the task prompt

Accédez à la page Fern dans la barre latérale de votre tableau de bord, ou appuyez sur ⌘N (Mac) ou Ctrl+N (Windows/Linux) depuis n'importe quel endroit dans Ferndesk.

2

Type your instructions

Décrivez ce dont vous avez besoin en langage clair. Soyez précis pour obtenir les meilleurs résultats :

• "Rédiger un guide de démarrage pour les nouveaux utilisateurs"

• "Mettre à jour l'article sur l'authentification API avec le nouveau flux OAuth"

• "Créer des documents de dépannage pour les erreurs de connexion"

Cliquez sur n'importe quelle carte de modèle sous la zone de saisie pour pré-remplir les demandes courantes.

3

Add context and attachments

Plus vous fournissez de contexte, meilleur sera le résultat de Fern. Vous pouvez joindre :

• Fichiers : Images (PNG, JPEG, GIF, WebP), vidéos (MP4, WebM, QuickTime) ou documents (PDF, TXT, DOC, XLS, CSV)

• Liens : Collez des URL externes ou des vidéos YouTube pour que Fern s'y réfère

• Références : Sélectionnez des articles, des collections ou des fils de discussion d'assistance existants pour donner à Fern des informations contextuelles

Faites glisser et déposez des fichiers, collez des captures d'écran ou utilisez les boutons de pièce jointe dans la boîte de dialogue de création de tâche.

4

Submit and track progress

Soumettez votre tâche et Fern commence ses recherches et sa rédaction. La tâche apparaît dans votre flux Fern où vous pouvez suivre sa progression. Les tâches avec des brouillons non publiés affichent une icône d'article indiquant qu'une révision est en attente.

Il existe trois façons de créer des tâches :

• Depuis la page Fern : Utilisez les méthodes ci-dessus pour créer des tâches directement

• À partir des recommandations d'audit : Lorsque Fern identifie des lacunes de contenu ou des articles obsolètes lors des audits, cliquez sur « Rédiger avec Fern » pour générer une tâche avec le contexte déjà joint

• À partir des intégrations : Si vous avez connecté Linear, créez des tâches de documentation directement à partir des tickets. Voir Comment utiliser Fern dans les tickets Linear.

Ce que les tâches peuvent faire

Fern peut gérer plusieurs types de travaux de documentation :

• Créer de nouveaux articles de toutes pièces en fonction de votre description

• Mettre à jour le contenu existant pour refléter les modifications du produit ou corriger les erreurs

• Rechercher et rédiger à partir de signaux d'assistance, de recommandations ou d'audits

• Réviser pour plus de clarté en réécrivant des sections ou en améliorant la structure

• Créer et supprimer des collections pour réorganiser la structure de votre centre d'aide

• Créer des sections pour les onglets de navigation de premier niveau

• Déplacer des articles et des collections entre différents emplacements

• Supprimer les articles et les collections qui sont obsolètes ou qui ne sont plus nécessaires

Ce que les tâches ne peuvent pas faire

• Répondre à des questions sur l'utilisation de Ferndesk : Trouvez plutôt les réponses dans le centre d'aide.

Révision et publication

Lorsque Fern a fini de rédiger un article, il apparaît au bas de votre fil de discussion de tâche.

• Si le résultat vous convient : Cliquez sur « Publier les modifications » pour les mettre en ligne immédiatement dans votre centre d'aide

• S'il nécessite des modifications : Envoyez un message à Fern avec des instructions supplémentaires (par exemple, « ajouter plus d'exemples de code » ou « rendre le ton moins technique »), ou fermez la tâche et créez-en une nouvelle avec des instructions affinées

• Si vous n'en voulez pas : Fermez ou ignorez la tâche

Après la publication d'une tâche

Une fois que vous avez publié une tâche, elle devient en lecture seule.

C'est intentionnel. Les tâches publiées sont verrouillées afin que vous puissiez examiner ce qui a été modifié sans le modifier à nouveau par accident.

Comment apporter d'autres modifications

Si vous devez mettre à jour du contenu qui a déjà été publié via une tâche :

1. Accédez à la page Fern pour commencer une nouvelle tâche

2. Décrivez ce que vous souhaitez modifier

3. Joignez les mêmes articles ou collections en tant que références afin que Fern dispose du bon contexte

La nouvelle tâche reprendra là où la précédente s'est arrêtée, avec un accès complet à l'état actuel de votre centre d'aide.

Conseils pour de meilleurs résultats

• @mentionnez des articles ou des collections pour dire à Fern de se concentrer sur eux

• Fournissez des exemples : Si vous souhaitez un format ou un style spécifique, incluez un exemple ou référencez un article similaire

• Joignez des documents d'appui : Captures d'écran, documents de spécifications, exemples de réponses API — tout ce qui aide Fern à comprendre la fonctionnalité

• Liez le contenu connexe : Référencez les articles existants pour que Fern maintienne la cohérence avec votre documentation actuelle

• Soyez direct sur le ton et l'audience : Spécifiez si vous écrivez pour des développeurs, des utilisateurs finaux, des administrateurs, etc.

Problèmes courants

Ressources associées

• Comment Fern crée des articles — Fonctionnement du processus de recherche et de rédaction

• Comment Fern audite votre centre d'aide — Comment Fern identifie les lacunes de documentation

• Présentation de la structure du centre d'aide — Comprendre les sections et les collections