Recherchez dans votre centre d’aide
Les lecteurs effectuent des recherches 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 API dans une seule liste classée, et les requêtes hors sujet peuvent renvoyer moins de correspondances, voire aucune.
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.
L’espace réservé est Rechercher un article ou demander à l’IA... lorsque Ask AI est disponible, ou Rechercher un article... sinon.
Ceci est différent de la recherche de fils de discussion dans l’espace de travail Fern, qui recherche uniquement les fils de discussion Fern, et non la documentation publiée.
Ce qui apparaît dans les résultats
Les résultats correspondants peuvent mélanger 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 API : la méthode HTTP, le chemin et un extrait facultatif mis en évidence
Seul le contenu public et visible pour le lecteur est éligible. Le contenu verrouillé ou privé n’apparaît pas dans la recherche publique.
Les résultats des articles et des API sont classés ensemble, de sorte que la meilleure correspondance pour la requête peut être de l’un ou l’autre type. Les opérations API pertinentes peuvent apparaître au-dessus des articles lorsqu’elles correspondent mieux à la requête, et l’inverse est également vrai.
Quand la recherche renvoie moins de résultats
La recherche conserve les résultats pertinents pour la requête. Elle ne remplit pas toujours la page.
Les requêtes sur votre produit doivent faire ressortir les articles et les opérations API les plus proches. Les requêtes sans contenu d’aide correspondant peuvent renvoyer une courte liste, voire aucune. Quand rien ne correspond, la boîte de dialogue affiche Aucun article trouvé.
Si les résultats semblent différents d’une visite précédente, le classement a peut-être modifié l’ordre d’apparition des correspondances, ou les correspondances faibles peuvent ne plus apparaître.
Langue
La recherche suit la langue consultée par le lecteur. Lorsqu’un lecteur utilise une langue activée autre que la langue par défaut, les candidats aux articles sont limités à cette langue avant le classement des résultats.
Améliorez ce que les lecteurs trouvent
La qualité de la recherche dépend du contenu publié. Pour renforcer les résultats :
Publiez des articles clairs pour les tâches que les lecteurs recherchent
Conservez les références API publiques lorsque les lecteurs doivent découvrir ces opérations dans la recherche
Examinez les recherches manquées dans les analyses 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) pour votre centre d’aide.