Rendre la documentation plus visible sur le forum ?

Je suis membre de ce forum depuis des années, mais je n’utilise jamais Documentation - Discourse Meta parce que j’oublie qu’il existe.

J’ai même pensé un jour : “ce serait bien s’il y avait un lien Docs dans la navigation principale…” et j’ai réalisé qu’il y en avait déjà un :

image

Pour une raison quelconque, mon cerveau l’a complètement ignoré.

De plus, le lien de la barre latérale est caché à la fin du menu Plus, auquel je pense (aucune donnée pour étayer cette pensée) que très peu de gens cliquent.

Je me suis aussi demandé si une icône à côté du bouton de navigation Docs aiderait mon cerveau à le remarquer.

image

Et que diriez-vous de le placer à côté du logo dans l’en-tête ? Peut-être deux liens ? Un pour Documentation - Discourse Meta, un pour https://docs.discourse.org/ ?

De plus, quelque chose me dérange :

  • Docs est la méta-documentation

  • Discourse Docs est le plugin.

  • #docs est le tag lié au plugin.

  • Les liens image et image mènent à Docs

  • #documentation est une catégorie non directement liée à Docs.

  • docs.discourse.org est la documentation de l’API.

Un peu déroutant, n’est-ce pas ?

Cela dit, le point principal est que j’ai toujours oublié que Documentation - Discourse Meta existe, et à cause de cela, je ne l’utilise jamais. Le plus proche que je fasse est d’utiliser la recherche, en commençant par #documentation.

7 « J'aime »

En prime, vous pouvez également utiliser le filtre in:docs dans vos recherches. :+1:

4 « J'aime »

Moi aussi !

Je pensais que c’était une blague. J’ai récemment déploré qu’il n’y ait AUCUN MOYEN DE TROUVER LA DOCUMENTATION. Mais, ce n’est pas une blague. C’est juste là. En plein jour.

Cela semble également vrai, sauf que je l’ai cherché l’autre jour et j’ai pensé que je ne le trouvais pas là, ou peut-être que je pensais juste qu’il ne fallait pas qu’il soit si caché.

Je ne suis pas sûr s’il s’agit d’un cas d’UX ou de “tu peux mener un cheval à l’abreuvoir”.

1 « J'aime »

Je pense qu’une petite partie du problème, que @chapoi a soulevée par le passé, est que ce menu n’est pas vraiment censé être un menu de navigation… c’est un menu de filtrage auquel nous avons ajouté quelques liens de navigation (catégories et docs).

Screenshot 2023-05-16 at 12.30.08 PM

Il serait probablement plus logique que les Docs résident dans la section « communauté » de la barre latérale, aux côtés d’autres liens de navigation (pas dans le tiroir). Cela pourrait le rendre moins découvrable si quelqu’un n’utilise pas la barre latérale, donc si le lien des docs doit être plus évident, nous devrions peut-être aussi le mentionner ailleurs :thinking:

5 « J'aime »

Pratiquement aucun de mes utilisateurs mobiles ordinaires n’utilise la barre latérale. Il n’y a rien dont ils aient besoin. Et… en fait, je les comprends.

3 « J'aime »

Je pense que c’est un cas pour « oui, et… »

Nous avons la documentation liée à trois endroits, en fait :

  • bannière pour les nouveaux utilisateurs anonymes
  • en-tête du filtre en haut
  • barre latérale

Ma suggestion serait de déplacer la documentation « au-dessus de la ligne de flottaison » dans la barre latérale, de sorte qu’elle apparaisse sous Sujets. Également pour lui donner une sorte de glyphe de livre :open_book:.

Également pour y ajouter une référence dans New to Discourse? Start here! qui est épinglé et que nous nous attendons à ce que les gens lisent lorsqu’ils rejoignent meta.

1 « J'aime »

J’ai ajouté Docs à la première partie du menu, sous Topics, pour voir à quoi cela ressemblerait. J’aime ça !

Cependant, je ne vois pas comment supprimer l’autre lien qui est ajouté automatiquement au bas de cette liste. Il faudrait probablement modifier le plugin pour qu’il cesse de l’afficher automatiquement ou le rendre configurable.

3 « J'aime »

Avec toutes nos excuses pour le triple post… Je l’ai de nouveau retiré de la barre latérale pour éviter la double liste des documents. Nous travaillons sur une solution pour permettre la personnalisation des éléments de la barre latérale pour les plugins, ce qui nous aidera ici.

1 « J'aime »