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 me gusta

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 Me gusta

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 me gusta

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 para esto. ¿Dónde está la documentación de Discourse?

¿Realmente no hay documentación para este proyecto aparte de la documentación de la API??

1 me gusta

Comienza con la categoría howto, en particular la subcategoría #howto:faq, que incluye algunas guías básicas para usuarios y administradores.

4 Me gusta

¡Genial! ¿Es posible agregar enlaces a estas páginas en https://docs.discourse.org? No son para nada obvias de encontrar, y sus URIs son sorprendentemente confusas.

No puedo hablar en nombre de discourse.org, pero no lo creo, ya que https://docs.discourse.org es la documentación de la API de Discourse para desarrolladores. Esos enlaces son para otros intereses.

Por cierto, usar esos enlaces sin una etiqueta útil es un comportamiento bastante poco útil.

La documentación podría mejorarse, pero es una tarea enorme para un producto de código abierto en constante cambio.

Si observas la categoría howto, verás una diversidad de intereses que, de todos modos, no pueden cubrirse en un solo documento:

  • #howto:devs
  • #howto:sysadmin
  • #howto:admins
  • #howto:cmgrs (gestores de comunidad)
  • #howto:faq, #howto:tips-and-tricks para todos

También hay una gran cantidad de superposición en los temas, algo muy evidente en otras categorías que afectan la experiencia de usuario (UX):

  • #theme
  • #plugin
2 Me gusta