A help button could be useful either way
We had this button on Stack Overflow and the analytics / data showed that almost nobody used it. That does not mean it should not exist, of course, but the general rule is that the type of people you would want to use this button, pretty much never do.
Stack Overflow seems way more aggressive these days for brand new users and audience for Discourse is way wider so this kind of approach may be applicable
I think there is definite value in giving some extra tips for tl0/tl1 that are getting accustomed and also for more advanced users that are looking for secret magic.
I guess what I want a little is a help mode that goes away after a bit
To be fair, there is a plugin that sort of permits this already and I don’t think a lot of people use it…
https://github.com/cpradio/discourse-plugin-composer-help-button
Granted, it isn’t right aligned, but it gives people a way to add customize help for the format bar should they deem that a necessity.
Also, this was written before the new outlet (that Canned Replies uses) to display help text at. So it could be improved to use that same location instead of a modal now (if someone has the time PR welcome).
Right-aligning the button might require a new outlet or a new option to the toolbar component (PR welcome for that too).
But those would be the only necessary improvements to make it meet the UI mock ups above.
None of that is new; I worked with Ben to add that in 2010/2011. See proof here…
Yeah it fealt eerily familiar. I guess I think there is merit for a help mode that kicks out once you posted a bit
But sure this can be plugin territory, agree that for seasoned users a help button is largely noise
For what it’s worth, I appreciate the comfort of being able to find some kind of formatting help, even if it’s rarely used.
It’s good for bootstrapping new users unfamiliar with markdown (like communities coming from more bb related forms, or with wysiwyg editors), and a nice reminder for when I just can’t figure out how how to do something simple like code formatting, and have been deep in JIRA or Sharepoint or something with vastly different formatting options.
إعادة نشر طلب أحدث لشيء مشابه - Hard to find the Markdown help button
رأيي في هذا:
الأشخاص عديمي الخبرة لا يعرفون حقًا كيفية استخدام ميزات ماركداون.
سيجعل دليل ماركداون الأمر أسهل للمستخدمين المبتدئين لتعلم ماركداون. نشر مستخدمون آخرون أشياء للمساعدة في ماركداون. أعتقد أنه سيكون من المفيد وجود هذه الميزة، لأنها ستساعد في سهولة الوصول.
كبديل، يمكننا أيضًا إضافة المزيد من أزرار ماركداون في الأعلى للمبتدئين. ومع ذلك، فإن المشكلة في ذلك هي أنها تجعل التخطيط أكثر إرباكًا.
أعتقد أنه ستكون فكرة رائعة إضافة هذا القسم (شريط الأدوات) إلى New User Tips أيضًا كما ذكر جيف أعلاه. ![]()
مع وصف قصير ورابط قابل للتكوين بداخله. يمكن أن يذهب إلى موضوع خاص حول التنسيق مثل Understanding Discourse for new users
أو يمكن أن يذهب مباشرة إلى مساعدة Markdown Markdown Reference
المستخدمون يرون:
اكتب هنا. استخدم Markdown أو BBCode أو HTML للتنسيق.
حسنًا، إنهم يستخدمون Markdown أو BBCode أو HTML، لكنهم يجدون أن بعض الأشياء لا تعمل،
وهناك أشياء أخرى يستخدمها مستخدمون آخرون وتعمل ولكنهم لم يكونوا يعرفونها.
لذلك هناك إصدارات مختلفة من Markdown أو BBCode أو HTML.
لذلك في المساعدة، يجب أن يذكر Discourse ما هي الإصدارات.
أو بدلاً من ذلك، ببساطة قم بإدراج قائمة كاملة بعناصر الترميز التي يستخدمها Discourse.
أو على الأقل قم بوضع رابط إلى مكان وجوده في الكود المصدري.
لكن المستخدمين العاديين لن يتمكنوا من فهم هذا الكود المصدري،
لذلك لا يزال من الأفضل وجود قائمة كاملة، أو تسميتها ورقة غش،
لمشغلات الترميز التي ينفذها Discourse.
إذًا أين يتم توثيق بناء الجملة [details=summary][/details]؟
- لم يتم ذكره في أي من الصفحات المشار إليها أعلاه نظرًا لأنه ميزة مخصصة لـ Discourse.
- يُظهر البحث عن “details” في meta أنه موجود وأنه قد يوصف بأنه “إخفاء” ولكنه لا يعطي أي تلميح حول كيفية عمل بناء جملة الملخص.
- يُظهر البحث على الويب مستودع discourse-details، ولكنه لا يحتوي الآن على أي معلومات باستثناء “تم إيقاف المكون الإضافي، وهو الآن جزء من Discourse افتراضيًا”.
- وجدتها أخيرًا في Details in topic styling changes - Feedback. ليس حيث أتوقع أن أرسل المستخدمين لمعرفة بناء الجملة.
كنت أود حقًا وجود زر مساعدة يربط ببعض التوثيق الرسمي…
إنه جزء من برنامج تعليمي لـ discobot
إذا نقرت على الترس، فسيعرض إدراجه لك
لذا، من المحتمل أن الأشخاص الذين لن ينقروا على الترس لن ينقروا أيضًا على أيقونة المساعدة. ![]()
هل يوجد درس تعليمي لـ discobot؟ لقد كنت أستخدم وأدعو إلى Discourse لسنوات عديدة ولم أصادف هذا قط، أو فكرة أنه المكان الذي يجب أن أذهب إليه للتعرف على كيفية استخدام Discourse. حتى الآن، ليس لدي أي فكرة (بالنظر إلى نسخة Discourse الخاصة بنا) كيف يمكنني تشغيل هذا.
اعتقدت أنني يجب أن أكون أفتقد شيئًا ما، أو ربما تم تقديم discobot بعد أن بدأت في استخدام Discourse لأول مرة، لذلك ذهبت إلى Understanding Discourse for new users. لا يوجد ذكر لدرس discobot التعليمي، أو [details]. يوجد Markdown Tutorial - Introduction مدرج، ولكن فقط لـ common mark.
@pfaffman أرى الآن هذا الخيار تحت الترس. ليس الأمر أنني لن أنقر على الترس، ولكنني اعتقدت أنني أعرف ما يعنيه الترس - لتغيير الإعدادات. (كنت مخطئًا.) هذا، جنبًا إلى جنب مع افتراض أنه من المحتمل أن تكون هناك مجموعة كاملة من الميزات الخاصة بـ Discourse مثل [details]، أقنعت نفسي بأنها لن تكون مدرجة جميعها تحت قائمة مخفية، لذلك بدأت في البحث عن دليل.
بالتأكيد كنت سأنقر على زر المساعدة إذا كان أحد الأزرار مخصصًا للمساعدة بوضوح (أي علامة استفهام). كنت سأنقر أيضًا على زر إذا كان مخصصًا للإدراج بوضوح. لقد أقنعت نفسي بشكل غير واعٍ أنه لا يمكن أن يكون التروس…
ربما أنا من المدرسة القديمة، لكنني أريد حقًا مصدرًا موثوقًا للقراءة حيث يمكنني التعرف على جميع الميزات والإشارة إليها في المستقبل. هل يوجد مثل هذا الشيء، أم أن التعلم من خلال الروبوتات هو الشيء الجديد؟
إنشاء حساب جديد على موقع Discourse.
لا شيء آخر غير متابعة الإعلانات هنا. كان هناك جهد متزايد لتوثيق الأشياء هنا في المستندات Documentation - Discourse Meta ولكن لا أعرف ما إذا كان هذا يبدو موثوقًا.
شكرًا لك. لذا، إذا أنشأت حسابًا جديدًا، فسأرى بالفعل discobot. ومع ذلك، من المحير جدًا كيفية التفاعل معه لمستخدم مثلي انضم قبل بدء discobot. قد يكون هذا خارج الموضوع قليلاً، ولكنه يسلط الضوء على الحاجة المحتملة لزر مساعدة، لذا سأبقي المناقشة هنا. لا تتردد في النقل، أو توجيهي إلى موضوع أفضل إذا كنت تعتقد أنه مناسب.
بعد اكتشاف discobot حديثًا، حاولت استخدامه على مواقعنا. وفقًا لمناقشات وذكرات مختلفة، توقعت أن أتمكن بطريقة ما من كتابة @discobot start tutorial في مكان ما والتعلم…
- جربت هذا في دردشة الموقع على أحد المواقع. لم يحدث شيء. حاولت تهيئة دردشة شخصية مع
@discobot، لكن لم يتم العثور عليه. - ثم حاولت إرسال “دردشة شخصية” إلى discobot. لم أستطع.
- في أحد مواقعنا، تمكنت من إضافة discobot إلى قائمة الدردشة الشخصية الخاصة بي، لكن الطلب منه “بدء البرنامج التعليمي” لم يفعل شيئًا.
- أخيرًا، أنشأت حسابًا جديدًا على هذا الموقع، واستقبلني الروبوت، مما أوضح أنه يجب أن يكون هناك موضوع يتضمن تفاعلاتي مع الروبوت (وأنه يجب علي وضع إشارة مرجعية على هذا الموضوع).
الآن أرى أنه يمكنني البحث عن discobot على موقعنا، والانتقال إلى صفحة المستخدم الخاصة به، ثم إرسال رسالة إليه، حيث أحتاج بشكل مربك إلى إدخال عنوان طويل وبعض المحتوى. أخيرًا، بعد إنشاء هذه الرسالة، يمكنني أن أطلب منه “بدء البرنامج التعليمي”.
لماذا هذا صعب جدًا؟ لماذا لا يستجيب الروبوت لطلبات بدء البرنامج التعليمي في الدردشات، أو الدردشات الخاصة، وما إلى ذلك؟ ماذا عن شخص يبدأ على موقع ويتجاوز إعدادات الإشعارات ولا يلاحظ discobot؟ كيف يحصلون على المساعدة لاحقًا؟
لا أعرف ما هو الحل الأفضل، لكن زر المساعدة في مكان ما يوجهني خلال هذا كان سيكون مفيدًا جدًا.
هل قمت بتعطيل ديسكوبوت في إعداداتك؟ هل تستخدم ديسكورس قديم جدًا؟



