Nouveaux logements pour la documentation officielle et communautaire

Je suis ravi d’annoncer quelques mises à jour concernant notre gestion de la documentation, afin de garantir clarté et collaboration tout en maintenant la qualité des informations fournies. Lisez la suite pour comprendre comment fonctionne notre nouvelle organisation de la documentation.

:writing_hand: Documentation officielle

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

Pourquoi uniquement les membres de l’équipe ?

Restreindre la création et la modification de la documentation officielle à notre équipe garantit cohérence et fiabilité. Nous visons à fournir des ressources précises et bien entretenues à tous, des nouveaux utilisateurs aux développeurs chevronné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 encore beaucoup d’espace pour vos contributions ! Toute la documentation contribué par la communauté est désormais disponible dans la catégorie Wiki. C’est là que l’expertise, les astuces et le savoir collectif de notre communauté dynamique se réunissent.

Qui peut contribuer ?

Les utilisateurs ayant un niveau de confiance 2 ou supérieur ont la possibilité de créer et modifier des sujets dans Wiki. Cela permet aux utilisateurs expérimentés de partager leurs connaissances, enrichissant ainsi et diversifiant nos ressources communautaires. Cela signifie également que les membres de confiance de la communauté peuvent modifier toute documentation communautaire qu’ils jugeraient incorrecte ou obsolète.

:question: Pourquoi ce changement ?

Cette politique vise à équilibrer le besoin d’une documentation officielle et entretenue avec les précieuses contributions de notre communauté. Elle offre également une structure claire aux utilisateurs à la recherche d’informations, qu’ils aient besoin de conseils officiels ou de recommandations communautaires.

Nous apprécions les contributions de chacun d’entre vous, et nous sommes convaincus que le passage à un espace dédié à vos contributions documentaires les aidera à s’épanouir 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é, dédié à l’apprentissage et au partage de connaissances. Nous aimerions recevoir encore plus de vos contributions. Si vous disposez de superbes tutoriels, configurations ou conseils, Wiki attend vos apports !


Vous pouvez trouver cette politique de documentation à son emplacement 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 dans les sujets de Documentation et Wiki en même temps.

La recherche inclura les sujets des 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 »