Créer et modifier des articles avec Fern

Les tâches sont le moyen de dire à Fern quoi créer ou mettre à jour dans votre centre d’aide. Fern se charge des recherches et de la rédaction, vous fournissez les instructions et examinez les résultats.

Créer une tâche

1

Ouvrir l’invite de tâche

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 où dans Ferndesk.

2

Saisissez vos instructions

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

• "Rédigez un guide de prise en main pour les nouveaux utilisateurs"

• "Mettez à jour l’article sur l’authentification de l’API avec le nouveau flux OAuth"

• "Créez de la 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

Ajouter du contexte et des pièces jointes

Plus vous fournissez de contexte, meilleure sera la sortie 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 les consulte

• Références : Sélectionnez des articles, collections ou fils de support existants pour fournir à Fern des informations de fond

Glissez-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

Envoyer et suivre la progression

Envoyez votre tâche et Fern commence les recherches et la rédaction. La tâche apparaît dans votre fil Fern, où vous pouvez suivre sa progression. Les tâches comportant 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

• Depuis les recommandations d’audit : Lorsque Fern identifie des lacunes de contenu ou des articles obsolètes dans les 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 prendre en charge plusieurs types de travail documentaire :

• Créer de nouveaux articles à partir de zéro selon votre description

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

• Faire des recherches et rédiger à partir des tendances du support, des recommandations ou des audits

• Modifier 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 des articles et des collections devenus obsolètes ou dont vous n’avez plus besoin

Ce que les tâches ne peuvent pas faire

• Répondre aux questions sur l’utilisation de Ferndesk : trouvez plutôt les réponses dans le centre d’aide.

• Modifier les traductions ou gérer le contenu dans une langue autre que la langue principale : Fern ne modifie que la langue principale de votre centre d’aide.

Révision et publication

Lorsque Fern termine la rédaction d’un article, celui-ci apparaît en bas de votre fil de tâche. Vous pouvez modifier directement le brouillon dans le fil de tâche avant de le publier.

• Si le résultat vous convient : cliquez sur "Publish changes" pour le mettre en ligne dans votre centre d’aide. La publication attend d’abord la fin de toute sauvegarde de brouillon en cours

• S’il faut des modifications : envoyez à Fern un message avec des instructions supplémentaires (par ex. : "ajoutez davantage d’exemples de code" ou "rendez le ton moins technique"), ou modifiez directement le brouillon dans le fil de tâche

• Si vous n’en voulez pas : fermez ou supprimez la tâche

Après la publication d’une tâche

Une fois que vous publiez une tâche, elle devient en lecture seule.

C’est intentionnel. Les tâches publiées sont verrouillées afin que vous puissiez vérifier ce qui a été modifié sans risquer de le modifier à nouveau par erreur.

Comment effectuer 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 lancer une nouvelle tâche

2. Décrivez ce que vous voulez 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.

Ce qui se passe avec les traductions

Fern ne publie que le contenu dans la langue principale. Si vous avez activé la gestion automatique des langues de traduction, la suite de traduction met automatiquement en file d’attente les traductions des nouveaux articles publiés. Les traductions apparaissent peu après la publication, et non instantanément. Si vous devez mettre à jour une traduction existante, utilisez le sélecteur de langue dans l’éditeur d’article ou allez dans Help Center > Translate pour retraduire tout le contenu de cette langue.

Conseils pour obtenir de meilleurs résultats

• @mentionnez des articles ou des collections pour indiquer à Fern de se concentrer dessus

• Fournissez des exemples : si vous voulez un format ou un style particulier, incluez un exemple ou faites référence à un article similaire

• Joignez des documents d’appui : captures d’écran, documents de spécification, exemples de réponse d’API — tout ce qui aide Fern à comprendre la fonctionnalité

• Liez le contenu associé : faites référence à 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 — Trouver les tâches, audits et modifications de code passés

• 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