من الصعب العثور على زر المساعدة الخاص بـ Markdown

قبل أيام قليلة كنت أتصفح لوحة الإعلانات هذه، وبحثت في كل مكان،
20230315T135552

لكنني لم أجد أي زر مساعدة لـ Markdown لشرح قواعد التنسيق.

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

حسنًا، ربما لم تكن أي وثائق جاهزة للمستخدمين العاديين بعد،

إعجابَين (2)

تحتوي شريط أدوات المؤلف على خيارات لتنسيق النص تلقائيًا وعرض كيفية عمله إذا كنت ترغب في إضافة Markdown [1] يدويًا. هل هذا ليس أكثر فائدة من رابط يأخذك إلى بعض الوثائق خارج الرسالة التي تكتبها؟


  1. وبعض BBCode اعتمادًا على ما تضيفه ↩︎

إعجابَين (2)

نعم. خذ المستخدم الذي يريد أن يقول “\nhttps://www.openstreetmap.org/\nليس\nhttps://www.openstreetmap.org/edit\n”\nحسنًا، في النهاية يكتشف الطريقة الصحيحة لجعلها تبدو هكذا “\nhttps://www.openstreetmap.org/، وليس\nhttps://www.openstreetmap.org/edit\n”.\nولكن لا توجد طريقة على الإطلاق كان بإمكانه اكتشافها لو لم يضطر إلى اكتشافها بنفسه، لأنه، هناك في المحرر، إنه لغز كبير، مع وثائق صفرية. صفر.

إعجابَين (2)

أنا أقول إنك بحاجة إلى رابط مثل هذا الرابط الأزرق على GitHub،

إعجابَين (2)

لديك طريقة مثيرة للاهتمام لاستخدام المستخدم، فهو أو أنت دائمًا ما تقصدني. مجرد قول.

يوجد في الويب ثلاثة أنواع مختلفة من المحررات عند إنشاء محتوى داخل خدمة:

  • نمط نظام إدارة المحتوى (CMS) مثل WordPress و Drupal وما إلى ذلك، حيث توجد الكثير من الأزرار (حسنًا، تبذل WordPress قصارى جهدها لكسر محررها، ولكن هذه قصة أخرى)
  • وسائل التواصل الاجتماعي المبسطة، مثل Facebook و Twitter وما إلى ذلك، حيث لا توجد أزرار أو توجد أزرار قليلة
  • عالم التطوير القديم، الذي يتكون في الغالب من مولدات المواقع الثابتة وما إلى ذلك، و Discourse

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

أدركت وسائل التواصل الاجتماعي أن عامة الناس لا يحتاجون إلى تلك الأزرار، لأنهم لا يستخدمونها - وعلى الهواتف المحمولة لا يوجد مجال. ولا يوجد زر مساعدة، لأنه لا حاجة له.

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

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

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

الحل الحقيقي لتجربة المستخدم/واجهة المستخدم هو إعطاء القدرة لـ:

  • المسؤولين لإنشاء افتراضيات للمستخدمين
  • السماح للمستخدمين بتغيير الافتراضيات

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

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

إعجابَين (2)

نعم، كنت أتحدث عن الحالة الواقعية حيث كنت أنشر

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

لذلك كان كل شيء يعتمد على التجربة والخطأ…

ثم جربت

https://www.openstreetmap.org/ .
https://www.openstreetmap.org/edit .

هذا يعطي مزيجًا غريبًا من
https://www.openstreetmap.org/ .
OpenStreetMap .

والذي، نعم، له منطقه الخاص، لكن هذه ليست نقطتي.
لا يزال الأمر ليس ما أردت أن تبدو عليه مشاركتي للآخرين.

بحلول هذا الوقت، فكرت “سألقي نظرة على الوثائق الرسمية بدلاً من ساعات من التجربة والخطأ.”
حسنًا، نظرت وبحثت ووجدت Formatting posts using markdown, BBCode, and HTML .

حسنًا، ذكر ذلك تنسيق
[url]http://bettercallsaul.com[/url]
، ولكن مع

[url]https://www.openstreetmap.org/[/url]
[url]https://www.openstreetmap.org/edit[/url]

شيء ما لا يعمل:
https://www.openstreetmap.org/
https://www.openstreetmap.org/edit
لذلك Formatting posts using markdown, BBCode, and HTML ربما يكون قديمًا، إلخ.

إذن كيف حللت مشكلتي أخيرًا، باستخدام

[https://www.openstreetmap.org/](https://www.openstreetmap.org/)، وليس
[https://www.openstreetmap.org/edit](https://www.openstreetmap.org/edit)

للحصول على
https://www.openstreetmap.org/، وليس
https://www.openstreetmap.org/edit
حسنًا، تذكرت أنكم تستخدمون “Markdown”، وتذكرت أن Markdown لديه تلك الصيغة، وأنها تعمل.

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

حسنًا، ضعها في قسم الأسئلة الشائعة، ثم اربط قسم الأسئلة الشائعة بالواجهة في مكان ما.

حسنًا، لنفترض أنك وضعت قسم الأسئلة الشائعة المستقبلي للتنسيق على موقع Discourse. تم حل المشكلة…
باستثناء كيف يعرف المستخدم أنه يستخدم Discourse؟ نعم، أنا أتحدث عن المستخدمين، وليس المسؤولين. شكرًا مرة أخرى.

إعجابَين (2)

للعلم فقط، هناك زر في المحرر يمكن أن يساعد:\n\n

\n\n\n\nإذا وضعت عنوان URL في المربع العلوي، والنص المعروض في المربع السفلي، فسيتم تنسيقه في لغة ماركداون لك. :+1:

5 إعجابات

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

مع النكهات المختلفة لـ markdown و BBCode و html التي تدعمها تجسيدات مختلفة لـ Discourse، لا يوجد دليل هناك في المستندات.

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

أرى أن هذا موجود:

إعجابَين (2)

مغلق لصالح Do we need a help button on the composer?