Basic Product Documentation

Внести вклад Функция
1

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 лайк
2

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 лайка
3

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 лайк
4

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.

5

This is great information. Thanks again!

6

+1 за это. Где документация Discourse?

Действительно ли для этого проекта нет никакой документации, кроме документации API??

1 лайк
7

Начните с категории howto, особенно с подкатегории #howto:faq, где содержатся базовые руководства для пользователей и администраторов.

4 лайка
8

Отлично! Можно ли добавить ссылки на эти страницы в https://docs.discourse.org? Их совсем неочевидно найти, а URI запутанно замысловаты.

9

Я не могу говорить от имени discourse.org, но я так не думаю, потому что https://docs.discourse.org — это документация по API Discourse для разработчиков. Эти ссылки относятся к другим направлениям.

Кстати, использование таких ссылок без полезной подписи — довольно непродуктивное поведение.

Документацию можно было бы улучшить, но это огромная работа для постоянно развивающегося продукта с открытым исходным кодом.

Если вы заглянете в категорию howto, то увидите разнообразие тем, которые невозможно охватить в одном документе:

  • #howto:devs
  • #howto:sysadmin
  • #howto:admins
  • #howto:cmgrs (управляющие сообществами)
  • #howto:faq, #howto:tips-and-tricks для всех

Также существует огромное количество пересечений тем, что особенно заметно в других категориях, влияющих на пользовательский опыт:

  • #theme
  • #plugin
2 лайка