Rechercher dans votre centre d’aide
Les lecteurs recherchent des informations dans votre centre d’aide public depuis la boîte de dialogue de recherche. Les résultats peuvent inclure à la fois des articles et des opérations de référence d’API dans une seule liste classée par pertinence, tandis que les requêtes hors sujet peuvent renvoyer moins de résultats, voire aucun.
Ouvrir la recherche
Dans votre centre d’aide public, ouvrez la recherche avec ⌘K (Mac) ou Ctrl+K (Windows/Linux). La boîte de dialogue affiche un champ de recherche en haut.
Le texte indicatif est Rechercher un article ou poser une question à l’IA... lorsque Poser une question à l’IA est disponible, ou Rechercher un article... dans le cas contraire.
Cette fonctionnalité est différente de la recherche dans les fils de discussion de l’espace de travail Fern, qui porte uniquement sur les fils de discussion Fern, et non sur la documentation publiée.
Ce qui apparaît dans les résultats
Les résultats correspondants peuvent combiner deux types sur la même page :
Articles : le titre de l’article et un extrait mis en évidence
Opérations de référence d’API : la méthode HTTP, le chemin et un extrait éventuellement mis en évidence
Seul le contenu public et visible par le lecteur peut être pris en compte. Le contenu auquel le lecteur ne peut pas accéder est exclu de la recherche publique. Les lecteurs autorisés peuvent trouver du contenu restreint, y compris du contenu dans des centres d’aide verrouillés.
Les résultats d’articles et d’API sont classés ensemble. Le résultat le plus pertinent pour une requête peut donc appartenir à l’un ou l’autre type. Des opérations d’API pertinentes peuvent apparaître avant les articles lorsqu’elles correspondent mieux à la requête, et inversement.
Lorsque la recherche renvoie moins de résultats
La recherche conserve les résultats pertinents pour la requête. Elle ne remplit pas toujours toute la page.
Les requêtes concernant votre produit devraient faire apparaître les articles et les opérations d’API les plus pertinents. Les requêtes ne correspondant à aucun contenu d’aide peuvent renvoyer une liste courte, voire aucun résultat. Lorsqu’aucun résultat ne correspond, la boîte de dialogue affiche Aucun article trouvé.
Si les résultats semblent différents de ceux affichés lors d’une visite précédente, le classement a peut-être modifié l’ordre d’apparition des résultats, ou les correspondances faibles peuvent ne plus être affichées.
Langue
La recherche suit la langue dans laquelle le lecteur consulte le centre d’aide. Lorsqu’un lecteur utilise une langue activée autre que la langue par défaut, les articles candidats sont limités à cette langue avant le classement des résultats.
Améliorer les résultats trouvés par les lecteurs
La qualité de la recherche dépend du contenu publié. Pour améliorer les résultats :
Publiez des articles clairs pour les tâches que les lecteurs recherchent
Laissez les références d’API publiques lorsque les lecteurs doivent pouvoir découvrir ces opérations dans les résultats de recherche
Consultez les recherches infructueuses dans les statistiques pour repérer les lacunes de contenu
Pour savoir comment les moteurs de recherche et les outils d’IA découvrent votre centre d’aide en dehors de la boîte de dialogue intégrée au produit, consultez Optimisation SEO et GEO (AEO) de votre centre d’aide.