Semaine de lancement : contributeurs, widgets multiples et API de journal des modifications
Le jour du lancement, nous avions promis de livrer autant que possible avant minuit. Voici ce qui a été mis en ligne cette semaine-là : un moyen plus sûr de permettre à davantage de membres de votre équipe de rédiger des docs, un widget pour chaque interface de votre produit et les premiers pas vers la possibilité de laisser vos propres outils gérer votre journal des modifications.
✍️ Rôle de contributeur : Permettez à davantage de collègues de rédiger des docs, en faisant réviser chaque modification avant sa mise en ligne
🧩 Widgets multiples : Un widget dans votre application, un autre sur votre portail développeur, chacun avec son propre contenu
🙋 Vous décidez de la suite lorsqu’un visiteur a besoin d’une personne : Redirigez-le, ajoutez du contexte ou prenez le relais depuis votre propre site
🧹 Les audits remettent de l’ordre dans votre structure : Fern repère les collections mal organisées et les réorganise pour vous
📣 API et webhook de journal des modifications : Créez des entrées depuis vos propres outils et déclenchez des e-mails de mise à jour lorsqu’elles sont publiées
🔍 Pourquoi Fern a effectué cette modification : Voyez exactement quelle phrase une pull request a rendue obsolète
Contributeurs et demandes de révision
Invitez vos collègues en tant que contributeurs. Ils peuvent rédiger des articles et travailler avec Fern, mais au lieu de publier, ils choisissent Soumettre pour révision et ajoutent une note facultative.
Les propriétaires et les administrateurs reçoivent un e-mail, et la demande apparaît dans Demandes de révision dans la barre latérale. Parcourez chaque modification de la demande, comparez chaque article à sa version en ligne et publiez en un clic. La publication est liée à la version exacte que vous avez révisée : rien ne change donc à votre insu.
Les contributeurs ne peuvent pas dépublier, supprimer ou déplacer des articles, modifier des collections ni changer les paramètres de l’espace de travail. Les mêmes règles s’appliquent à leurs clés API et à leurs connexions aux outils d’IA. Chaque membre, y compris les contributeurs, occupe un siège. Voir Équipe.
Plusieurs widgets, chacun avec son propre contenu
Vous pouvez désormais créer, nommer et gérer plusieurs widgets depuis le tableau de bord, chacun avec son apparence, ses paramètres et son extrait d’installation. Chaque carte de widget affiche un aperçu et les données d’activité des 30 derniers jours.
Chaque widget peut également exclure des sections du centre d’aide. Votre widget intégré à l’application peut se limiter à l’aide sur le produit, tandis que celui de votre portail développeur se limite à la documentation de l’API. Les sections exclues n’apparaissent pas dans l’onglet de navigation, les résultats de recherche, les journaux des modifications ni les réponses de l’IA de ce widget. Cela limite ce qu’un widget affiche, mais ne restreint pas l’accès : pour cela, utilisez les paramètres d’accès aux sections. Sélectionnez-les dans Widget > Personnaliser > Contenu. Voir Configurer les paramètres du widget.
Vous décidez de la suite lorsqu’un visiteur a besoin d’une personne
Lorsque Fern ne peut pas répondre, ou qu’un visiteur demande à parler à une personne, votre site peut désormais prendre le relais. Le widget déclenche les événements escalationOffered et escalationRequested. Vous pouvez ainsi afficher vos propres options (comme les délais de réponse ou le passage à une offre supérieure), rediriger le visiteur vers un autre outil de chat ou prendre entièrement le relais.
Vous pouvez également configurer des déclencheurs de transfert dans Paramètres > Assistant IA. Fern répond toujours aux questions couvertes par votre documentation, puis ajoute une étiquette au transfert pour que votre site puisse l’acheminer au bon endroit. Sans gestionnaire ni déclencheur, rien ne change. Voir Escalade et comportement de transfert de l’IA et la référence du SDK.
Les audits remettent désormais de l’ordre dans votre structure
Les centres d’aide deviennent désorganisés à mesure qu’ils grandissent : deux collections qui couvrent le même sujet, des dossiers imbriqués sur quatre niveaux. Chaque audit examine désormais l’organisation de vos sections et collections (pour les centres d’aide contenant au moins 10 articles qui ne sont pas synchronisés depuis une autre plateforme) et suggère jusqu’à trois correctifs clairs, comme « Fusionner Paiements avec la collection Facturation ». Chaque résultat présente les déplacements prévus en détail ; en lui attribuant une action, vous demandez à Fern de réorganiser vos collections.
Une structure bien organisée ne génère aucun résultat, pour éviter les tâches inutiles. Fern ne déplace jamais de contenu d’une section ou d’un public à l’autre, et ne touche jamais aux journaux des modifications. Voir Comment Fern audite votre centre d’aide.
API et webhook de journal des modifications
Les journaux des modifications font désormais partie de l’API publique. Consultez les journaux et leurs entrées, créez des brouillons d’entrée depuis vos propres outils (ou votre propre agent d’IA), modifiez-les et publiez-les. Voir Créer une entrée de journal des modifications.
Le nouveau webhook changelog_entry.published se déclenche une fois lorsqu’une entrée est publiée, avec son titre, son lien, sa date, ses étiquettes et son contenu en HTML et en Markdown. Il ne se déclenche pas à nouveau lors des modifications ultérieures : vous pouvez donc l’utiliser sans risque pour envoyer des e-mails de mise à jour. Voir Entrée de journal des modifications publiée.
Pourquoi Fern a effectué cette modification
Avant d’approuver une mise à jour de la documentation issue d’une pull request fusionnée, ouvrez Pourquoi Fern a effectué cette modification. Vous verrez ce qui a changé dans votre produit (nouveautés, modifications, déplacements, renommages, suppressions ou correctifs), le niveau de confiance de Fern, la phrase exacte de chaque article rendue obsolète par la pull request et tout élément qu’elle n’a pas pu confirmer.
Chaque modification de code indique également qui a ouvert la pull request. Vos collègues peuvent ainsi repérer leur travail d’un coup d’œil, et vous pouvez rechercher des discussions par nom d’utilisateur GitHub. Voir Brouillons automatiques de PR.
Autres améliorations
Les intégrations s’ajustent correctement en hauteur : Les intégrations HTML personnalisées qui occupent tout l’écran, comme les explorateurs d’API, font à peu près la hauteur d’un écran au lieu de créer un immense espace vide.
Une meilleure page 404 : Vous êtes perdu sur ferndesk.com ? Aidez Fern à corriger un centre d’aide obsolète pendant que vous y êtes.
Correctifs
L’éditeur d’images ouvre désormais toutes les images, y compris celles importées depuis des plateformes qui les envoient sans type de fichier approprié.
Les messages du formulaire de contact conservent leurs sauts de ligne lorsqu’ils arrivent dans votre boîte de réception.
La page des tâches de Fern ne cesse plus de se mettre à jour pendant les premières secondes d’une tâche ni juste après avoir cliqué sur Arrêter.
Bon à savoir
Les collections fusionnées ne redirigent pas encore : Lorsque Fern fusionne des collections pendant un audit, l’URL de l’ancienne collection cesse de fonctionner. Ajoutez une redirection dans les redirections du centre d’aide si elle était référencée ailleurs.