Vérifiez chaque semaine les modifications de Fern
Fern rédige des mises à jour lorsque vous livrez des nouveautés. Lorsque la Vérification continue est activée dans Fern > Personnaliser > Automatisations, Fern signale aussi les articles qui ne correspondent plus à votre produit. Rien n’est publié sans l’approbation de quelqu’un. Une courte vérification hebdomadaire suffit donc à garder votre documentation à jour.
Confiez cette tâche à une personne, généralement celle qui livre le plus de nouveautés produit. Les responsables et les administrateurs peuvent publier. Les contributeurs peuvent modifier les brouillons de Fern et les envoyer pour révision.
Traitez les demandes de révision, en commençant par les plus anciennes
La section Demandes de révision regroupe les modifications envoyées par vos collègues pour révision, ainsi que les éventuelles notes ajoutées. Elle apparaît dans la barre latérale des responsables et des administrateurs lorsqu’une demande est en attente.
Parcourez les brouillons de Fern
Dans Fern, filtrez la liste avec Contient des brouillons. Un brouillon issu d’une pull request fusionnée indique la pull request, son auteur et la raison de la modification apportée par Fern. Si une pull request ne doit pas être documentée, sélectionnez Non pertinent.
Vérifiez les faits, pas la formulation
Fern reprend le style de votre centre d’aide. En revanche, Fern ne peut pas connaître les intentions, par exemple si une fonctionnalité est encore en bêta ou si une limite doit changer. Modifiez directement le détail concerné ou indiquez à Fern quoi faire dans la tâche, puis publiez.
Traitez les vérifications
Ouvrez Vérification et parcourez la section À vérifier. Elle se remplit automatiquement lorsque la Vérification continue est activée. Sinon, lancez une vérification avec Vérifier la documentation. Demandez à Fern de rédiger une correction, ou sélectionnez Ce n’est pas un problème lorsque la différence n’a pas d’importance pour les clients. Si vous sélectionnez cette option par erreur, restaurez l’article depuis l’onglet Ignorés. Consultez Garder les articles à jour.
Parcourez rapidement le dernier audit
Lorsqu’un audit planifié s’exécute, il apparaît dans la liste de Fern, sous Audits. Utilisez Rédiger avec Fern pour les résultats à traiter et ignorez les autres.
À quelle fréquence
Quand | Que faire |
|---|---|
Chaque semaine | Les cinq étapes ci-dessus |
Le jour où une fonctionnalité importante est fusionnée | Demandez à Fern de la rédiger immédiatement. Consultez Quand vous livrez une nouveauté importante. |
Chaque mois | Recherchez les requêtes sans résultat et demandez à Fern de traiter les sujets correspondants. Consultez Consulter les rapports du centre d’aide. |
La révision fonctionne lorsque la liste reste courte et que votre agent IA transmet rarement des questions auxquelles votre documentation devrait répondre.