أرى أن هناك شارة تسمى “مرخّص”، ويُوصفها بأنها “أكملت الدليل المتقدم للمستخدم.” المواضيع هنا تشير إلى أنه يمكن بدء الدليل المتقدم عن طريق كتابة “@discobot start advanced user”، لكن في النسخة المستضافة لدي، لا يتم فهمها.
ما الذي فاتني؟
Hi! To find out what I can do, say @discobot display help.
الأمر لبدء الدليل المتقدم لـ discobot هو:
@discobot start advanced tutorial
ربما يجب تضمين تفاصيل حول بدء الدليل المتقدم في المنشور الذي يُنشأ عندما ينشر المستخدم @discobot display help؟
شكرًا لك، هذا يعمل! نعم، يبدو لي تمامًا منطقيًا أن يعرض خيار “عرض المساعدة” هذا. الآن بعد أن عرفت الصيغة، أستطيع أن أرى كيف يحاول رسالة المساعدة الحالية إخباري بما يجب قوله، لكنها ليست واضحة على الإطلاق.
أليس كذلك؟
@discobot عرض المساعدة
I currently know how to do the following things:
@discobot start tutorial
Starts one of the following interactive tutorials: tutorial, advanced tutorial.
@discobot roll 2d6
3, 6
@discobot quote
Carry out a random act of kindness, with no expectation of reward, safe in the knowledge that one day someone might do the same for you — Princess Diana
@discobot fortune
You may rely on it
يبدو صحيحًا بالنسبة لي ↑ ↑ @nedbat
إذا كان بإمكاني اقتراح تعديل:
لم يكن واضحًا بالنسبة لي أن جزء “tutorial, advanced tutorial” كان من المفترض استخدامه كجزء من الأمر.
نفس الأمر! لقد أثار مشرفو لديّ نفس المخاوف.
أقصد .. ربما؟ هل نحتاج حقًا إلى أمثلة متعددة، مثل: هل يقرأ شخص ما
@discobot roll 2d6
ويحتاج حقًا إلى رؤية
@discobot roll 12d20
@discobot roll 1d10
لفهم أنه يمكن استبدال الأرقام حسب الحاجة؟ 
ومع ذلك، من الإنصاف ملاحظة أن الدليل التعليمي فقط هو الذي يتوقع كلمات مختلفة، مثل:
@discobot start {name-of-tutorial}
حيث يمكن أن يكون {name-of-tutorial} إما tutorial أو advanced tutorial.
عندما يكون هناك احتمالان فقط، بدلاً من كل عدد طبيعي، فإن الأمر يستحق ذكرهما صراحةً.
فكرتك تناسبني أيضًا.
لا يمكن تعديل النص بسهولة؛ فهو مبرمج
`@%{discobot_username} %{reset_trigger} %{default_track}`
> يبدأ أحد الدروس التفاعلية التالية: %{tracks}.
لا أقصد أن أركز على هذا الأمر أكثر من اللازم، ولكن: يمكنك بسهولة تعديل هذا النص إذا قررت أن مساعدة المستخدمين في العثور على الدرسين الحاليين أهم من تطبيق مبدأ YAGNI (لا تبنِ شيئًا لم يحتاجه بعد) من أجل احتمال مستقبلي لدرس ثالث.
أو، انقل بناء أوامر البوت إلى كود Ruby. لن يتغير النص من لغة إلى أخرى.
أو، غيّر الأمر إلى اقتراحك:
`@%{discobot_username} %{reset_trigger} {اسم-التدريب}`
> يبدأ تدريبًا تفاعليًا. يمكن أن يكون `{اسم-التدريب}` أحد الخيارات التالية: `%{tracks}`.
(طلب سحب: Clarify how to start a tutorial by nedbat · Pull Request #7944 · discourse/discourse · GitHub)