جعل المستندات أكثر وضوحًا في المنتدى؟

لقد كنت عضوًا في هذا المنتدى لسنوات، لكنني لا أستخدم Documentation - Discourse Meta أبدًا لأنني أنسى وجوده.

لقد فكرت ذات مرة، “سيكون من الرائع لو كان هناك رابط للوثائق في التنقل العلوي…” ثم أدركت أنه موجود بالفعل:

image

لسبب ما، تجاهل عقلي ذلك تمامًا.

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

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

image

وماذا عن وضعه بجوار الشعار في الرأس؟ ربما رابطان؟ أحدهما لـ https://meta.discourse.org/docs، والآخر لـ https://docs.discourse.org/؟

أيضًا، هناك شيء يزعجني:

  • الوثائق هي وثائق وصفية (meta documentation)
  • وثائق Discourse هي المكون الإضافي.
  • #docs هو الوسم المتعلق بالمكون الإضافي.
  • الروابط image و image تؤدي إلى الوثائق
  • #documentation هي فئة غير مرتبطة مباشرة بالوثائق.
  • docs.discourse.org هي وثائق واجهة برمجة التطبيقات (API).

مربك بعض الشيء، أليس كذلك؟

ومع ذلك، فإن النقطة الرئيسية هي أنني نسيت دائمًا أن Documentation - Discourse Meta موجود، وبسبب هذا، لم أستخدمه أبدًا. أقرب ما أفعله هو استخدام البحث، بدءًا بـ #documentation.

7 إعجابات

كمكافأة إضافية، يمكنك أيضًا استخدام عامل التصفية in:docs في بحثك أيضًا. :+1:

4 إعجابات

وأنا أيضاً!

افترضت أن هذه مزحة. لقد تذمرت مؤخرًا من أنه لا توجد طريقة للعثور على المستندات. لكن هذه ليست مزحة. إنه موجود هناك. واضح وضوح الشمس.

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

لست متأكدًا مما إذا كانت هذه حالة تجربة مستخدم أو “يمكنك قيادة حصان إلى الماء”.

إعجاب واحد (1)

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

Screenshot 2023-05-16 at 12.30.08 PM

من المحتمل أن يكون من المنطقي أن تعيش الوثائق في قسم “المجتمع” في الشريط الجانبي بجوار روابط التنقل الأخرى (وليس في الدرج). قد يجعل هذا اكتشافها أقل إذا لم يستخدم شخص ما الشريط الجانبي، لذلك إذا كان رابط الوثائق يحتاج إلى أن يكون أكثر وضوحًا، فقد نحتاج أيضًا إلى الإشارة إليه في مكان آخر :thinking:

5 إعجابات

عمليًا لا أحد من مستخدمي العاديين على الهاتف المحمول يستخدم الشريط الجانبي. لا يوجد شيء يشعرون بالحاجة إليه. و… في الواقع، أنا أفهمهم.

3 إعجابات

أعتقد أن هذه حالة لـ “نعم، و…”

لدينا المستندات مرتبطة في ثلاثة أماكن، في الواقع:

  • لافتة للمستخدمين الجدد وغير المعروفين
  • رأس الفلتر في الأعلى
  • الشريط الجانبي

اقتراحي هو أن ننقل المستندات إلى “أعلى الصفحة” في الشريط الجانبي، بحيث تظهر تحت المواضيع. وأيضًا لإعطائها نوعًا من رمز الكتاب :open_book: .

وأيضًا لإضافة إشارة إليها في New to Discourse? Start here! وهو مثبت ونتوقع من الناس قراءته عند الانضمام إلى meta.

إعجاب واحد (1)

لقد أضفت للتو “المستندات” إلى الجزء الأول من القائمة، تحت “المواضيع”، لمعرفة كيف ستبدو. لقد أعجبتني!

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

3 إعجابات

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

إعجاب واحد (1)