Créer et modifier des articles avec Fern

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

Créer une tâche

1

Open the task prompt

Rendez-vous sur la page Fern dans la barre latérale de votre tableau de bord, ou appuyez sur ⌘N (Mac) ou Ctrl+N (Windows/Linux) n'importe où 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édige un guide de démarrage pour les nouveaux utilisateurs"

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

• "Crée une documentation 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 puisse s'y référer

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

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 commencera ses recherches et sa rédaction. La tâche apparaîtra dans votre flux Fern où vous pourrez 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 directement des tâches

• Depuis les recommandations d'audit : Lorsque Fern identifie des lacunes de contenu ou des articles obsolètes lors des audits, cliquez sur "Draft with Fern" pour générer une tâche avec le contexte déjà joint

• Depuis les 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 à partir de zéro en fonction de votre description

• Mettre à jour le contenu existant pour refléter les changements de produit ou corriger des erreurs

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

• Éditer 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 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, celui-ci apparaît en bas de votre fil de discussion de tâche. Vous pouvez modifier le brouillon directement dans le fil avant de le publier.

• Si le résultat vous convient : Cliquez sur "Publish changes" pour les mettre en ligne dans votre centre d'aide. La publication attend que toute sauvegarde de brouillon active soit terminée avant de s'effectuer

• S'il nécessite des modifications : Envoyez un message à Fern avec des instructions supplémentaires (par exemple, "ajoute plus d'exemples de code" ou "rends le ton moins technique"), ou modifiez le brouillon directement dans le fil de discussion

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

Après la publication d'une tâche

Une fois que vous publiez une tâche, elle devient accessible 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 risquer de le rééditer par accident.

Comment apporter d'autres modifications

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

1. Allez sur 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 pour 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.

Ce qui se passe avec les traductions

Si vous avez activé les langues de traduction gérées automatiquement, les traductions des articles nouvellement publiés sont mises en file d'attente automatiquement. Les traductions apparaissent peu après la publication, pas instantanément.

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 d'API — tout ce qui aide Fern à comprendre la fonctionnalité

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

• Soyez direct sur le ton et l'audience : Précisez 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 — Comment fonctionne le processus de recherche et de rédaction

• Rechercher des fils de discussion dans l'espace de travail Fern — Trouvez les tâches passées, les audits et les modifications de code

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

• Aperçu de la structure du centre d'aide — Comprendre les sections et les collections