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

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

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

Here’s an example:

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。Discourse のドキュメントはどこですか?

このプロジェクトには、API ドキュメント以外に実際のドキュメントがないのでしょうか?

「いいね!」 1

howto カテゴリ、特に基本的なユーザーおよび管理者ガイドが含まれる #howto:faq サブカテゴリから始めてください。

「いいね!」 4

素晴らしい!https://docs.discourse.org にこれらのページへのリンクを追加することは可能でしょうか?これらのページは非常に探しにくく、URI もなぜか非常に分かりにくいです。

discourse.org については私にはわかりませんが、私はそうは思いません。https://docs.discourse.org は開発者向けの Discourse API ドキュメントだからです。それらのリンクは他の目的のためのものです。

ちなみに、有用なラベルなしでそれらのリンクを使用するのは、あまり役に立たない行動です。

ドキュメントは改善できるかもしれませんが、それは絶えず変化しているオープンソース製品にとって大きな仕事です。

howto カテゴリを見ると、1つのドキュメントでカバーできない多様な関心があることがわかります:

  • #howto:devs
  • #howto:sysadmin
  • #howto:admins
  • #howto:cmgrs (コミュニティマネージャー)
  • #howto:faq, #howto:tips-and-tricks (すべての人向け)

また、トピックの重複も非常に多く、UXに影響を与える他のカテゴリでもそれが明らかです:

「いいね!」 2