Basic Product Documentation

Hi, I’m new to Discourse and I’m just looking for basic documentation about features. Searching these forums so far hasn’t yielded the kind of information I’m looking for. I particularly want to know about what badges, groups, and trust levels are intended for, and what functionality options they carry. Sorry if this is a duplicate.

1 « J'aime »

Badges are there to encourage experimenting with features and reward great content. They are a substitute for the user manual.

Groups are 100% about security, if you need a particular group of users to see content that nobody else can see, you start with a group. Then you assign the group to a category.

There is a trust level explanation topic in the faq category here, but in general, trust level lets users have more community cleanup and moderation powers as they spend more time on the site.

4 « J'aime »

Jeff,

Thanks for the info! Can you elaborate on what you mean when you say badges are a substitute for the user manual? That’s the only part I’m not sure I understand.

1 « J'aime »

Here’s an example:

http://blog.codinghorror.com/level-one-the-intro-stage/

Badges give you a set of objectives that you can achieve in your own order, on your own terms, and you “explore” the product to get there.

This is great information. Thanks again!

+1 pour ça. Où se trouve la documentation de Discourse ?

Y a-t-il vraiment aucune documentation pour ce projet en dehors de la documentation de l’API ?

1 « J'aime »

Commencez par la catégorie howto, en particulier la sous-catégorie #howto:faq, qui contient des guides de base pour les utilisateurs et les administrateurs.

4 « J'aime »

Super ! Est-il possible d’ajouter des liens vers ces pages sur https://docs.discourse.org ? Elles ne sont absolument pas évidentes à trouver, et leurs URI sont d’une complexité déroutante

Je ne peux pas parler au nom de discourse.org, mais je ne pense pas que ce soit le cas, car https://docs.discourse.org est la documentation de l’API Discourse destinée aux développeurs. Ces liens concernent d’autres centres d’intérêt.

D’ailleurs, utiliser ces liens sans libellé utile est plutôt un comportement peu utile.

La documentation pourrait être améliorée, mais c’est une tâche immense pour un produit open-source en constante évolution.

Si vous consultez la catégorie howto, vous verrez une diversité d’intérêts qui ne peut de toute façon pas être couverte dans un seul document :

  • #howto:devs
  • #howto:sysadmin
  • #howto:admins
  • #howto:cmgrs (gestionnaires de communauté)
  • #howto:faq, #howto:tips-and-tricks pour tout le monde

Il y a aussi énormément de chevauchements entre les sujets, ce qui est très évident dans d’autres catégories qui impactent l’UX :

  • #theme
  • #plugin
2 « J'aime »