Documentation : Astuces et conseils pour utiliser la recherche

Premièrement, quelques métadonnées générales :wink:

Sur mon forum, j’ai utilisé un nombre décent de catégories. Principalement parce que j’avais la même structure sur d’autres sites et que tout le monde fait de même. Mais comme tout le monde le sait, ou devrait le savoir, une multitude de catégories et de nombreuses sous-catégories, plus toutes les sous-sous-catégories, sont presque impossibles à gérer. Et le plus important : les catégories n’aident pas un utilisateur à trouver du contenu pertinent.

Rien de nouveau en fait. C’est une des raisons pour lesquelles Discourse ne prend en charge que les catégories à deux niveaux et que l’utilisation des tags est si souvent encouragée.

Cependant, beaucoup sont contre les tags. Je pense que cela conduit à une mauvaise utilisation des tags sur d’autres plateformes, en les mélangeant avec des mots-clés (en partie, les tags et les mots-clés sont les mêmes) et à l’abus de hashtags par Instagram, etc. De plus… le point de vue commun est qu’à cause de cette histoire, les utilisateurs ordinaires ne savent pas comment utiliser les tags.

Ils le peuvent. Pour eux, ce qu’ils voient à l’écran, les tags sont la même chose que les catégories — mais donnent de meilleurs résultats (SI utilisés correctement par les administrateurs).

Mais les tags fonctionnent mieux avec les recherches. Et c’est aussi un problème. Comme les tags sont largement mal utilisés, il en va de même pour les recherches — car cela ne fonctionne tout simplement pas. Les utilisateurs ont appris à ne pas utiliser la recherche, car elle donne trop de résultats. C’est une lutte sans fin entre les compétences des utilisateurs, faut-il montrer tous les résultats à un utilisateur ou peut-on utiliser une sorte de devinette comme le fait Google.

C’est un problème que les développeurs doivent résoudre. Mais c’est une autre histoire.

Quoi qu’il en soit. Mon public est constitué de gens ordinaires, pas du tout experts en technologie. Ils ont des difficultés à commencer à utiliser le compositeur de Discourse et ils ne pouvaient pas changer de thème. Bien sûr, ils le peuvent maintenant, pour la plupart, mais cela a nécessité beaucoup de conseils.

Mais ils s’adaptent au manque de catégories et ont commencé à utiliser les tags immédiatement. Pour eux, c’était un acte vraiment intuitif. Ou comme l’ont dit quelques utilisateurs : cliquer sur les tags, c’est comme chercher, mais en mieux. Tout ce que j’ai eu à faire en termes de conseils, c’est de leur dire de cliquer sur les tags et de découvrir ce qui se passe, et de leur dire où Tags dans le hamburger mène.

Retour au sujet

Discourse possède l’un des meilleurs moteurs de recherche du monde web gratuit. Il n’est pas parfait, bien sûr, mais il est bien supérieur à la recherche native de WordPress ou d’autres CMS (si vous ne connaissez pas le plugin de recherche WordPress Relevantti, vous devriez y jeter un œil ; il est assez bon).

J’apprends maintenant à mes utilisateurs comment améliorer les résultats de recherche. En fait, même cela a été une tâche beaucoup plus facile que ce que j’avais prévu — et ces utilisateurs n’utilisent presque jamais la recherche nulle part (je ne les blâme pas, car les recherches sont souvent nulles).

Mais maintenant, il me manque des références. Je sais que Discourse peut utiliser de nombreuses astuces directement dans les termes de recherche — mais ces fragments et bribes de connaissances sont dispersés dans… de nombreux messages et sujets.

Je sais — écrire un document et des astuces demande plus de travail que le codage lui-même. J’ai beaucoup fait de documentation. Il ne s’agit pas seulement d’en écrire un, mais il doit y avoir au moins trois documents différents selon les besoins et les compétences des utilisateurs. De plus, quelqu’un devrait aussi les tenir à jour.

C’est pourquoi je comprends tout à fait que je ne puisse pas trouver un guide complet pour maîtriser les recherches sur Discourse :wink: (ou je ne peux tout simplement pas chercher)

Ce que je demande à la communauté, c’est :

  • une simple liste de paramètres de recherche (ou des exemples/liens)
  • apprendre à vos utilisateurs à utiliser la recherche, la plupart d’entre eux ne le peuvent tout simplement pas
  • abandonner les catégories et commencer à utiliser les tags à la place (bon, cela demande une certaine planification pour bien faire les choses, cependant)
6 « J'aime »

Tout à fait d’accord. Il existe 2 excellents plugins qui peuvent également améliorer l’expérience utilisateur avec les recherches.

  • Recherches enregistrées
  • Docs

Cependant, oui, la mise en place de guides de forum est un must absolu pour aider les utilisateurs à mieux utiliser un forum et à améliorer leur expérience. C’est là que le plugin Docs peut certainement être un atout. Il existe également un composant de thème qui peut être utilisé avec le plugin Docs.

1 « J'aime »

@hugh / @JammyDodger avons-nous besoin de quelque chose comme cela dans le sujet de la documentation ?

3 « J'aime »

Il y a Searching for content effectively

4 « J'aime »

Génial, j’ai tout intégré (en utilisant claude-3.5-sonnet) et je suis satisfait de la modification, mais n’hésitez pas à examiner.

4 « J'aime »

J’en ai supprimé la plupart parce que :

J’aime que le sujet mette en évidence les filtres que je ne peux pas découvrir en utilisant la recherche avancée. Si vous souhaitez modifier la portée, annulez simplement la modification.

J’ai laissé les options de tri car elles ne sont pas affichées dans le champ de saisie de la recherche, il est donc plus difficile de les utiliser sans la liste déroulante.

1 « J'aime »

Je pense qu’il serait préférable de changer la portée… cette règle semble très arbitraire. Peut-être pourrions-nous simplement supprimer « Ce sujet vise à lister d’autres filtres qui ne sont pas disponibles dans le formulaire de recherche avancée » ?

@JammyDodger Qu’en penses-tu ?

Je comprends que l’on puisse découvrir beaucoup de choses en cliquant, mais la documentation vous évite cela. De plus, cette modification rend la recherche moins performante.

Par exemple :

recherche de suivi ne trouvera plus ce document, ce qui est dommage.

3 « J'aime »