Examinez chaque semaine les modifications de Fern
Fern prépare des mises à jour lorsque vous livrez des nouveautés. Lorsque la vérification continue est activée dans Fern > Personnaliser > Automatisations, Fern signale également les articles qui ne correspondent plus à votre produit. Rien n’est publié sans l’intervention d’une personne : un rapide examen hebdomadaire suffit donc à maintenir votre documentation à jour.
Confiez cette tâche à une seule personne, généralement celle qui livre le plus de nouveautés produit. Les propriétaires et les administrateurs peuvent publier. Les contributeurs peuvent modifier les brouillons de Fern et les soumettre pour examen.
Traitez les demandes d’examen, en commençant par les plus anciennes
La section Demandes d’examen regroupe les modifications soumises par les membres de l’équipe, ainsi que les notes qu’ils ont ajoutées. Elle répertorie également les modifications effectuées via MCP ou l’API, même si personne ne les a soumises pour examen, jusqu’à leur publication ou leur rejet. Elle apparaît dans la barre latérale des propriétaires et des administrateurs lorsqu’une demande est en attente.
Examinez les brouillons de Fern
Dans Fern, filtrez la liste pour afficher Avec 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 adopte 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 vous prévoyez de modifier une limite. Modifiez directement le détail concerné ou indiquez à Fern quoi changer dans la tâche, puis publiez.
Traitez les vérifications
Ouvrez Vérification et examinez les éléments de À examiner. Cette liste 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 la correction, ou choisissez Aucun problème lorsque la différence n’a pas d’importance pour les clients. Si vous choisissez cette option par erreur, restaurez l’article depuis l’onglet Écartés. Consultez Maintenir les articles à jour.
Parcourez le dernier audit
Lorsqu’un audit planifié est exécuté, il apparaît dans la liste de Fern, sous Audits. Utilisez Rédiger avec Fern pour les résultats à traiter et écartez les autres.
Fréquence
Quand | Que faire |
|---|---|
Chaque semaine | Les cinq étapes ci-dessus |
Le jour où une fonctionnalité majeure est fusionnée | Demandez à Fern de la rédiger sans attendre. Consultez Lorsque vous livrez une nouveauté importante. |
Chaque mois | Repérez les recherches qui n’ont donné aucun résultat et demandez à Fern de traiter ces sujets. Consultez Consulter les rapports du centre d’aide. |
L’examen est efficace lorsque la liste reste courte et que votre agent IA transmet rarement des questions auxquelles votre documentation devrait répondre.