Documentation dans un forum de discussion

Ce serait formidable si vous pouviez démarrer un sujet Site feedback et développer un peu cela. :+1: Nous avons beaucoup de sites qui utilisent une catégorie comme base de connaissances, tout comme nous, et nous cherchons toujours des moyens de nous améliorer si vous avez des idées ou des commentaires à offrir.

Merci. Je faisais surtout référence au fait que les « docs basés sur la discussion » ont tendance à être un travail difficile pour les nouveaux utilisateurs, car cela implique souvent de lire un article suivi d’un fil de discussion qui met à jour ou modifie le message original. Mais je ne parle que pour moi-même, bien sûr, et je peux voir que d’autres pourraient ne pas le voir ainsi :slight_smile:

1 « J'aime »

Oui, je n’aime pas ça non plus. :slight_smile: Et les longues chaînes de réponses peuvent souvent sembler intimidantes en soi. L’idée ici (bien que j’apprécie qu’il y ait souvent un décalage) est de déplacer toutes les informations pertinentes dans le message d’origine afin de ne pas avoir cette situation. Nous essayons également de séparer les discussions distinctes en sujets distincts (étiquetés, lorsque nous le pouvons) pour les rendre plus faciles à rechercher. Nous avons également des minuteurs de suppression automatique qui effacent les anciennes réponses après un certain temps. C’est un travail en cours, mais j’espère que nous allons dans la bonne direction. :slight_smile:

2 « J'aime »

Oui. Je pense que dans une certaine mesure, on ne peut pas éviter les confusions, mais c’est bien de savoir que vous essayez (bien que je doute que vous alliez jusqu’à supprimer des commentaires qui ont été incorporés dans un OP édité ultérieurement, ce qui est souvent la principale perte de temps).

Mais mon point de départ n’était pas vraiment celui-là. Je pense avoir réalisé un peu trop tard que vous n’êtes bien sûr pas un projet F/LOSS, donc vous n’appréciez peut-être pas que des inconnus comme moi essaient d’offrir de « l’aide ».

1 « J'aime »

Nous apprécions la documentation et les conseils créés par la communauté. :+1:

Le minuteur de suppression automatique est plutôt peu discriminant, il peut donc être une arme à double tranchant. :slight_smile: Mais l’intention est de détacher la suggestion de modifier le document dans un sujet distinct afin de conserver l’historique lorsque cela est nécessaire/utile. C’est un processus, euh, ‘organique’, vous pourriez donc trouver certains/de nombreux exemples où ce n’est pas le cas. :slight_smile:

Bien que nous soyons raisonnablement réactifs si vous repérez quelque chose et pensez qu’il devrait être modifié/amélioré d’une manière ou d’une autre. :+1:

1 « J'aime »

Ce n’est pas à cela que je faisais référence, avez-vous regardé le lien que j’ai fourni ?

Je ne vous dirigeais pas vers la catégorie des documents, /docs est plutôt généré par le plugin discourse docs.

L’interface est assez différente, plus proche d’un système de gestion des connaissances typique, avec une recherche et des filtres ciblés. Elle omet les réponses, qui sont périodiquement regroupées dans le message original, comme vous pouvez le voir dans l’historique des modifications.

Merci, mais je ne suis pas sûr de la pertinence de cela par rapport à la conversation que je pensais avoir commencée, donc je l’ai un peu ignoré, j’en ai peur. C’est bien de savoir qu’un tel plugin existe, ne vous méprenez pas :slight_smile:

Suite à votre commentaire selon lequel la documentation n’était pas dans un format approprié ou découvrable, j’ai partagé ici sur Meta un lien vers l’outil qui présente la documentation dans un format différent et inclut des fonctionnalités qui facilitent la découvrabilité.

Je comprends qu’étant issu du milieu des facteurs, l’approche différente adoptée ici peut ne pas vous être immédiatement familière. En tant que personne qui a passé une grande partie des neuf dernières années à offrir de l’aide ici sur Meta, je peux vous assurer qu’il est incroyablement utile d’avoir la documentation à proximité de la discussion de support.

1 « J'aime »

Je vois, désolé, j’avais mal compris.

Je suis tout à fait d’accord pour que vous fassiez ce que vous voulez. Je voulais juste savoir si vous apprécieriez que je soumette une PR au dépôt pour ajouter des instructions d’installation supplémentaires. Je vois que la réponse est non.

Alors je me retire et vous remercie de votre indulgence :slight_smile:

1 « J'aime »

J’aime cette catégorie Documentation et je l’ai souvent utilisée. Je suis confuse car je ne vois pas de raisons évidentes pour lesquelles elle ne serait pas idéale. :woman_shrugging:t2:

Il y a beaucoup d’informations utiles là-bas et soumettre une contribution serait apprécié et probablement utile à d’autres.