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 に影響を与える他のカテゴリでもそれが明白です:

  • #theme
  • #plugin
「いいね!」 2