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:

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 للجميع

كما أن هناك تداخلًا كبيرًا في المواضيع، وهو أمر واضح جدًا في الفئات الأخرى التي تؤثر على تجربة المستخدم (UX):

  • #theme
  • #plugin
إعجابَين (2)