تضمين مزيد من التلميحات عبر Discourse التي ترتبط بوثائق ذات صلة على Meta

السياق

ذكر فريق Discourse في أماكن قليلة أنهم يسعون لتحسين تجربة المسؤول.

المشكلة

هناك الكثير من الإعدادات في Discourse والكثير من الوثائق. ولكن من غير المرجح أن تجد الوثائق الصحيحة في الوقت المناسب.

ميزة

يمكن أن يكون هناك المزيد من الأماكن في إعدادات وقوائم Discourse حيث يتم ربط الوثائق المقابلة في \u003chttps://meta.discourse.org/docs\u003e.

على سبيل المثال، هناك منشور المدونة Understanding Discourse Trust Levels الذي يتم ربطه في تثبيتات Discourse.

ولكن هناك الكثير غيرها غير مرتبطة.

على سبيل المثال، هناك دليل حول حذف فئة.

يبدو أن هذا سيكون ذا صلة/مفيدًا لتضمينه في النافذة المنبثقة حيث يمكنك رؤية زر حذف الفئات.

يمكن أن يكون رابطًا، ولكنه لا يجب أن يكون مجرد رابط لكل حالة - يمكن أن يكون زر علامة استفهام يربط بالوثيقة، أو يمكن أن يكون “اقرأ المزيد…” إلخ.

يمكن لفريق Discourse تصفح الوثائق، بدءًا من الوثائق الرئيسية، وتحديد المكان الأكثر ملاءمة في البرنامج لربط تلك الوثيقة.

(المعروف أيضًا باسم “في الوقت المناسب”)

أمثلة أخرى للبرامج

يحتوي Ghost (برنامج تدوين مفتوح المصدر) على عدد قليل من الأماكن التي ترتبط فيها وثائقه، في الوقت الذي تحتاجه فيه بالضبط.

على سبيل المثال، هذا الزر “اعرف المزيد” يربط بالوثيقة ذات الصلة:

نفس الشيء هنا:

لم أكن متأكدًا مما إذا كان هذا يناسب Feature أو #ux، فلا تتردد في نقله.

5 إعجابات

سأختلف قليلاً مع ذلك. هناك نطاقات مختلفة لمحتوى المساعدة يمكنك إنشاؤه. إذا اتبعنا نموذج Diátaxis، فهو عبارة عن دروس تعليمية، وأدلة إرشادية، ومراجع، وشروحات.

ربما يكون للدروس التعليمية مكان للربط بها داخل التطبيق نفسه، بحيث إذا دخلت إلى صفحة بنية “أريد أن أتعلم كيف يعمل هذا”، يمكنك تعلم ذلك، حتى لو لم تكن الصفحة واضحة بذاتها. ربما حتى مركز دروس تعليمية يتيح لك إكمال دورة تدريبية حول البرنامج إذا كنت ترغب في ذلك.

الفئات الثلاث الأخرى أواجه فيها بعض المشاكل.

إذا ذهبت إلى صفحة إعدادات الفئة، فقد يكون هناك 20 شيئًا مختلفًا أرغب في القيام به. وضع دليل إرشادي هناك سيؤدي إلى قائمة أحتاج إلى البحث فيها - ولأن لدي توقعًا بأن ما أبحث عنه لن يكون له بالضرورة مقال إرشادي مخصص، فمن المحتمل أن أكتب هذا السؤال في Google بدلاً من البحث في القائمة.

المراجع الخارجية هي آفة أتعامل معها يوميًا. لدينا “دليل مرجعي” يخبرك بما تفعله كل شريط تمرير وزر، وصولاً إلى:

زر الإلغاء: يغلق مربع الحوار دون تطبيق التغييرات
زر موافق: يغلق مربع الحوار، مع تطبيق التغييرات

استخدام هذا المرجع يعني أنه يتعين عليك التمرير فوق الكثير من الأشياء التقنية قبل الوصول إلى قسمك، عندما كان كل ما تحتاجه حقًا هو تلميح يعيد صياغة خيار بضع كلمات إضافية.

إذا حاولت حذف فئة، فإن السلوك الحالي يكاد يكون مرغوبًا فيه. أرى الزر، عادةً ما يكون باهتًا ولكن مع علامة استفهام، وإذا نقرت عليه، فإنه يقول:

لا يمكن حذف هذه الفئة لأنها تحتوي على فئات فرعية.

أو:

لا يمكن حذف هذه الفئة لأنها تحتوي على 25852 موضوعًا. أقدم موضوع هو…

السلوك جيد، أعرف ما هو الخطأ وما هي خطوتي التالية - حذف مجموعة من المشاركات والفئات الفرعية. لن يتحسن ذلك بربط دليل إرشادي “لحذف فئة” بدلاً من ذلك.

بالطبع، لا يزال هذا حلاً مؤقتًا للمشكلة الحقيقية: لماذا لا يسمح لي بحذف فئة تحتوي على مشاركات فيها؟ يمكنني حذف المجلدات التي تحتوي على مجلدات فرعية وملفات على نظامي، فلماذا لا يمكنني حذف الفئات التي تحتوي على فئات فرعية ومشاركات؟ إذا لم يكن لديها هذه القيود الغريبة، فلن تكون هناك حاجة لدليل إرشادي في التطبيق في المقام الأول.

وأخيرًا، الشروحات - هذا هو ما يمثله منشور المدونة “فهم مستويات الثقة”. عندما واجهته لأول مرة، كان مربكًا للغاية - “هل منشور مدونة عشوائي من 6 سنوات مضت هو أفضل ما لديك كوثائق؟” - ويربط بمقال مرجعي يسرد كل الأشياء في جدول، والذي كان أكثر توافقًا مع ما توقعته (على الرغم من أنه لم يتم فرزه بالطريقة التي توقعتها). الشروحات لا تساعدني في إنجاز مهمة مباشرة، لذا فإن وضعها في مكان سيتم فيه إنجاز مهمة لا يعمل بشكل جيد.


أعتقد في النهاية، بينما الوثائق مهمة في بعض الأماكن (مثل الإعداد، أو في الحالات التي يفشل فيها التصميم)، فإن التصميم هو الذي يجب أن يكون التركيز الأساسي. نادرًا ما تكون قراءة أو مشاهدة فيديو يشرح فيه شخص ما الموقع لك هي التجربة المرغوبة.

5 إعجابات

نعم، بصفتي طالب تصميم ألعاب سابقًا، أتفق معك تمامًا. (أتذكر أنك مصمم لـ Audacity. بالمناسبة، أستخدم Audacity كثيرًا، وأنا ممتن جدًا له!)

أعتقد أيضًا أنه يمكن إعادة التفكير في التجربة بأكملها من الألف إلى الياء (بدءًا من التفكير: “ما الذي يرغب المسؤول في القيام به، وكيف يمكننا مساعدته على القيام بذلك على أفضل وجه؟” لجميع حالات الاستخدام) لتقديم العمليات بشكل أفضل ولجعل العمليات نفسها واضحة قدر الإمكان.

بالنسبة للمثال هناك - وهو عدم السماح لك بحذف فئة إذا كانت تحتوي على مواضيع فيها - يمكن أن تكون طريقة أكثر سلاسة للبرنامج للتعامل مع ذلك على النحو التالي. عندما تحاول حذف فئة تحتوي على مواضيع فيها، يمكن أن تقترح أولاً ما إذا كنت ترغب في:

  • نقل جميع المواضيع الموجودة إلى فئة أخرى، أو
  • وضع جميع المواضيع الموجودة في “غير مصنف”، أو
  • حذف جميع المواضيع في الفئة

ثم تأكيد رغبتك في حذف الفئة.

أعتقد أن رؤية فريق Discourse يتجه نحو تغييرات تدريجية في هذه المرحلة:

كنت أناشد تحقيق نتيجة أسهل - إضافة بعض الروابط إلى الوثائق الأكثر شيوعًا / العادية / الرئيسية حيثما كان ذلك أكثر ملاءمة.

(قد أقوم أيضًا بإنشاء موضوع جديد لاحقًا لملاحظات / اقتراحات التحسين التي تحدثنا عنها هنا، حول تحسين تجربة حذف الفئات.)

أنا معجب جدًا بهذا الاقتراح - شكرًا لتسليط الضوء عليه، @bloomexperiment! نحن نعمل حاليًا على تحسين الهيكل العام وتصنيف وثائقنا، وأعتقد أن هذا النوع من الميزات سيكون جديرًا بالاهتمام للنظر فيه كجزء من تلك العملية. سأضيفه إلى خارطة طريق الوثائق كشيء لاستكشافه، وسنرى كيف يمكن تنفيذه على أفضل وجه.

إعجابَين (2)

عذرًا لإحياء موضوع قديم، وأنا على دراية تامة بالعمل الحالي الذي يجري حول البحث الإداري وتحسين تجربة الإدارة بشكل عام. في كثير من الأحيان خلال الأسابيع القليلة الماضية، كنت أفكر كم أتمنى لو كان اسم كل إعداد للموقع رابطًا للموضوع الوثائقي ذي الصلة على Meta. على مدار السنوات القليلة الماضية، تحسنت وثائق Meta بشكل كبير، وهي الآن شاملة ومنظمة وغنية بالمعلومات للغاية.

مثال:

في المثال أعلاه، أود أن يرتبط “موقع النسخ الاحتياطي” بموضوع Meta مثل Configure automatic backups for Discourse

هل يمكننا الاقتراب تدريجيًا من مرحلة ترتبط فيها أسماء إعدادات الموقع هذه بالخيط ذي الصلة في Meta؟ يمكنني أن أرى أنك قد لا ترغب في ترميز عناوين URL بشكل ثابت في كود Discourse، ولكن أعتقد أنه يمكن أن يكون في نصوص الموقع بطريقة ما.

إن العمل على ربط كل هذا كبير، ولكن ربما يكون جهدًا جماعيًا عبر عدد من المستضيفين الذاتيين ممكنًا؟

3 إعجابات