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 Mi Piace

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 Mi Piace

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 Mi Piace

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 per questo. Dove si trova la documentazione di Discourse?

Non esiste davvero altra documentazione per questo progetto oltre a quella delle API??

1 Mi Piace

Inizia con la categoria howto, in particolare la sottocategoria #howto:faq, che contiene alcune guide di base per utenti e amministratori.

4 Mi Piace

Fantastico! È possibile aggiungere link a queste pagine su https://docs.discourse.org? Non sono affatto facili da trovare e i loro URI sono sorprendentemente oscuri

Non posso parlare per discourse.org, ma non credo sia così, perché https://docs.discourse.org è la documentazione API di Discourse per gli sviluppatori. Quei link riguardano altri interessi.

A proposito, utilizzare quei link senza un’etichetta utile è un comportamento piuttosto poco utile.

La documentazione potrebbe essere migliorata, ma si tratta di un lavoro enorme per un prodotto open-source in continua evoluzione.

Se guardate nella categoria howto, noterete una diversità di interessi che non può comunque essere soddisfatta in un unico documento:

  • #howto:devs
  • #howto:sysadmin
  • #howto:admins
  • #howto:cmgrs (community manager)
  • #howto:faq, #howto:tips-and-tricks per tutti

C’è anche un’enorme sovrapposizione di argomenti, cosa molto evidente in altre categorie che influenzano l’UX:

  • #theme
  • #plugin
2 Mi Piace