Nouveaux logements pour la documentation officielle et communautaire

Je suis ravi d’annoncer quelques mises à jour sur la façon dont nous gérons la documentation afin d’assurer la clarté et la collaboration tout en maintenant la qualité des informations fournies. Lisez la suite pour comprendre le fonctionnement de notre nouvelle configuration de documentation.

:writing_hand: Documentation officielle

Nous avons mis à jour la catégorie Documentation pour qu’elle soit exclusivement dédiée à la documentation officielle. Cela signifie que tout le contenu de ses sous-catégories est géré par les membres de l’équipe Discourse, garantissant que les informations sont exactes et à jour. Si vous recherchez les guides et références les plus fiables, c’est le bon endroit !

Pourquoi uniquement les membres de l’équipe ?

Restreindre la création et la modification de la documentation officielle à notre équipe garantit la cohérence et la fiabilité. Nous visons à fournir des ressources précises et bien entretenues pour tout le monde, des nouveaux utilisateurs aux développeurs expérimentés. Tous les membres de la communauté peuvent toujours répondre à ces sujets pour discuter du contenu ou suggérer des modifications.

:people_hugging: Wiki communautaire

Ne vous inquiétez pas, il y a aussi beaucoup de place pour vos contributions ! Toute la documentation contribuée par la communauté se trouve désormais dans la catégorie Community wiki. C’est là que l’expertise, les conseils et les connaissances collectives de notre communauté dynamique se réunissent.

Qui peut contribuer ?

Les utilisateurs de niveau de confiance 2 et supérieur ont le pouvoir de créer et de modifier des sujets dans Community wiki. Cela permet aux utilisateurs expérimentés de partager leurs connaissances, ajoutant ainsi de la richesse et de la diversité à nos ressources communautaires. Cela signifie également que les membres de confiance de la communauté peuvent modifier toute documentation communautaire qu’ils trouvent incorrecte ou obsolète.

:question: Pourquoi ce changement ?

Cette politique est conçue pour équilibrer le besoin d’une documentation officielle et maintenue avec les précieuses contributions de notre communauté. Elle offre également une structure claire aux utilisateurs qui recherchent des informations, qu’ils aient besoin de conseils officiels ou d’avis communautaires.

Nous apprécions les contributions de chacun d’entre vous, et nous pensons que le déménagement vers un espace dédié à vos contributions de documentation les aidera à prospérer et à recevoir l’attention qu’elles méritent.

:derek_pointing: Nous avons besoin de vous !

Le wiki communautaire a déjà une longueur d’avance pour devenir un espace robuste, piloté par la communauté, pour l’apprentissage et le partage des connaissances, et nous aimerions avoir plus de vos commentaires. Si vous avez d’excellents tutoriels, configurations ou conseils, Community wiki attend vos contributions !


Vous pouvez trouver cette politique de documentation dans son lieu de résidence permanent ici :

10 « J'aime »

Puis-je savoir ce qu’il adviendra du badge Scribe ?

4 « J'aime »

Existe-t-il un moyen simple de rechercher simultanément dans les deux sources de documentation ? Je sais que je peux rechercher dans plusieurs catégories, mais c’est plus fastidieux que d’ajouter simplement « Documentation » avec l’aide de l’autocomplétion.

Je pense que je peux utiliser in:docs à la place, car les deux catégories y sont ajoutées ? in:kb, qui a également fonctionné pour Discourse Docs, ne semble pas fonctionner.

Et comment cela fonctionne-t-il pour les sous-catégories ? Par exemple, comment puis-je rechercher toutes les informations écrites pour les utilisateurs. Puis-je rechercher en même temps dans Community wiki > Users et Documentation > Using Discourse ?

5 « J'aime »

Un exemple de balise classique. Mais… il y aurait alors une quantité tellement énorme de balises qu’il serait presque impossible de les gérer.

3 « J'aime »

Le badge Scribe a été mis à jour pour couvrir les contributions au wiki communautaire :slight_smile:

3 « J'aime »

Oui - vous pouvez utiliser in:docs et cela recherchera simultanément les sujets dans Documentation et Community wiki.

La recherche inclura les sujets dans les sous-catégories, donc ceux-ci font déjà partie des résultats.

Pour cela, vous devrez spécifier categories:users,using-discourse dans la recherche.

2 « J'aime »

Mais toutes ces options nécessitent une connaissance approfondie de Discourse, car aucune d’entre elles n’est prise en charge dans l’interface de recherche (avancée).
La documentation ne devrait-elle pas être aussi facile à rechercher que possible ?

5 « J'aime »

Je pense que cela met plutôt en évidence les points que nous pouvons améliorer dans l’interface utilisateur de Discourse. Notamment, permettre la sélection de plusieurs catégories dans la recherche avancée, entre autres choses.

Cela présente une excellente opportunité et une motivation supplémentaire pour travailler sur des mises à jour comme celle-ci, nous verrons donc ce que nous pouvons faire ! Nous en discuterons, et je reviendrai ici avec toute mise à jour.

4 « J'aime »