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 板块,你会发现兴趣点多种多样,根本无法在一篇文档中涵盖:

  • #howto:devs
  • #howto:sysadmin
  • #howto:admins
  • #howto:cmgrs(社区经理)
  • #howto:faq、#howto:tips-and-tricks 面向所有人

此外,主题之间存在着大量的交叉重叠,这在影响用户体验的其他板块中也十分明显:

2 个赞