C’est un pas en arrière par rapport au plugin Docs original, à mon avis.
Je suis fortement en désaccord ici. Cela nous donne beaucoup plus de flexibilité dans l’apparence de notre documentation. De plus, cela permet également de lier des pages d’autres catégories, et même des liens externes.
1 « J'aime »
Mais avec des milliers de documents et de nouveaux documents ajoutés fréquemment, cela en fait une tâche très manuelle.
2 « J'aime »
D’accord, je ne sais pas si je gérerais 1000 pages de documentation avec Discourse. Je pourrais m’imaginer le faire même s’il existe des solutions de documentation plus adaptées… 1000 pages sans Git semble aussi… douloureux 
Pourquoi pas ? Cela fonctionne très bien avec les documents originaux. Par exemple, nous avons des sujets dans la catégorie « Bibliothèque » qui contiennent un ou plusieurs PDF ou d’autres pièces jointes en plus du texte du message. Chaque sujet est également étiqueté comme applicable, de sorte que trouver des éléments est très facile avec la recherche et le filtrage par étiquettes.
C’est peut-être une question d’utilisation. Vous pourriez vous y habituer en utilisant Discourse comme documentation dès le début, mais dans mon domaine (documentation technique/utilisateur), j’aurais de toute façon besoin d’un index manuel.
J’ai constaté qu’il est très facile pour le mainteneur de rechercher et de trouver des publications.
Mais du point de vue d’un utilisateur qui ne connaît pas votre produit ou qui est nouveau dans le domaine, il pourrait ne pas savoir quoi rechercher. Dans ce cas, la structuration a beaucoup de sens (d’après mon expérience) ou les utilisateurs se perdent dans le labyrinthe de la documentation. Vous pouvez le tester vous-même, pensez à 5 à 10 documents aléatoires dans diverses balises que vous vous attendez à ce que vos utilisateurs lisent. Essayez ensuite de les trouver en cliquant simplement sur votre site. Si vous avez du mal à les trouver vous-même, vous pouvez imaginer quelle serait l’expérience utilisateur.
2 « J'aime »
La recherche d’informations est facile grâce au filtrage. Supposons que vous recherchiez des instructions d’installation de moteur pour le modèle d’avion Glastar. Vous ne savez pas exactement quoi chercher, mais les concepts sont faciles à rechercher et à filtrer :
Avec l’ancienne version de Docs, tout ce que je mettais dans la catégorie Bibliothèque était automatiquement ajouté à Docs. Il n’y a pas de maintenance manuelle d’un index séparé, ce à quoi je m’oppose.
1 « J'aime »
Je suis d’accord que la conception actuelle n’est pas idéale.
Nous avions besoin de flexibilité et avons accumulé des dettes techniques pour l’obtenir. C’est la raison principale pour laquelle nous considérons Discourse Doc Categories comme experimental pour le moment.
Notre intention est de concevoir et de construire quelque chose de mieux ici un jour, mais ce n’est pas une priorité actuellement.
5 « J'aime »
Je pense que le problème est que le plugin d’origine que de nombreux sites ont adopté et implémenté de manière extensive est maintenant marqué comme end-of-life malgré le fait qu’il n’offre pas de pont pratique vers le nouveau.
Je viens de mettre en œuvre quelques KM sur un site utilisant le nouveau plugin, donc l’expérience est encore fraîche dans mon esprit. Devoir organiser un sujet d’index pour voir quoi que ce soit dans la vue des documents semble vraiment peu élégant. L’implémentation de l’ancien plugin était comparativement transparente, à condition qu’une taxonomie de balises décente existe.
Je peux comprendre que de nouveaux besoins ont conduit à la création de Discourse Doc Categories, mais de votre propre aveu, nous sommes coincés entre un plugin experimental qui ne répond pas aux besoins actuels et l’ancien plugin qui a une durée de vie limitée.
7 « J'aime »
Je suis tout à fait d’accord avec Stephen.
Je me demande pourquoi cela a été abordé comme un tout nouveau plugin plutôt qu’une évolution de l’original. Les révolutions dans le domaine des logiciels peuvent être puissantes, mais elles fonctionnent mieux lorsqu’elles sont rapides et décisives.
3 « J'aime »
En fait, je n’utilise pas le plugin Docs pour gérer la documentation — j’ai seulement besoin d’une interface simple pour filtrer les sujets par plusieurs catégories et plusieurs tags à la fois, le tout sur la même page.
L’interface Discourse par défaut nécessite de passer par la Recherche avancée, qui est trop cachée et inclut de nombreux filtres dont je n’ai pas besoin (comme l’auteur ou la date). Je recherche une expérience plus ciblée et directe.
L’ancien plugin Docs m’aide à réaliser ce filtrage multi-catégories et multi-tags, mais il présente encore une limitation :
Lorsque je sélectionne une catégorie parente, il n’affiche que les sujets directement dans cette catégorie parente — il n’inclut pas les sujets de ses sous-catégories.
En revanche, la vue de catégorie par défaut affiche les sujets des catégories parentes et des sous-catégories.
C’est pourquoi j’utilise toujours le plugin, même s’il n’est pas idéal.
Voici ma précédente demande à ce sujet : Multi menu select Group tags
Merci encore à tous ceux qui ont pris le temps de discuter et d’aider à affiner cela — votre soutien et vos idées sont profondément appréciés.
2 « J'aime »