توثيق للروابط الصامتة

الرابط الصامت هو أي رابط Discourse مع إضافة ?silent=true إلى عنوان URL الخاص به. عند استخدامه، يؤدي هذا إلى كتم الإشعارات لمؤلف المنشور أو الموضوع المرتبط.

كيفية الاستخدام:
أضف ?silent=true إلى نهاية رابط الموضوع أو المنشور الخاص بك.
مثال:

https://yoursite.com/t/topic-title/123?silent=true

فوائد لملفات فهرس الوثائق

يُنصح بشدة بتضمين الروابط الصامتة في مواضيع فهرس الوثائق وقواعد المعرفة لعدة أسباب:

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

مراجع

6 إعجابات