لقد جعلنا مؤخرًا إضافة التوثيق الجديدة متاحة للاختبار وجمع الملاحظات. تم تصميم هذه الإضافة لتعزيز التنقل وإمكانية الوصول إلى الوثائق المستضافة على Discourse، مما يوفر تجربة أكثر سهولة وودية لجميع المستخدمين. لاحظ أن هذه الإضافة لا تزال قيد التطوير.
ينبع تطوير هذه الإضافة من جهودنا المستمرة لتحسين التوثيق، والذي تم تعزيزه بالفعل بشريط جانبي جديد. وضع الشريط الجانبي الأساس لتجربة توثيق محسنة بشكل كبير، وتضيف الإضافة الجديدة تدريجيًا إلى هذا العمل.
الإضافة الجديدة قيد العمل
تعمل الإضافة حاليًا وتدعم التوثيق على توثيق Discourse الرسمي. ندعوك لاستكشاف ميزاتها ومشاركة تجاربك معنا. ملاحظاتك لا تقدر بثمن في مساعدتنا على تحسين الإضافة وتعزيزها.
الميزات الأساسية المتضمنة في الإضافة الجديدة هي:
إعدادات لتحديد الفئات المستخدمة للتوثيق
شريط جانبي توثيق جديد يتم ملؤه بمواضيع الفهرس داخل كل فئة
تقريران جديدان للمساعدة في الحفاظ على سلامة ودقة مواضيع الفهرس
مع المزيد قيد التطوير بينما نعمل باستمرار على تحسين الميزات المتاحة.
بينما نبتكر ونتقدم، سنقوم بإيقاف إضافة Discourse Docs القديمة. ومع ذلك، يمكنك أن تطمئن إلى أننا سنستمر في دعمها حتى تكون الإضافة الجديدة جاهزة تمامًا للإصدار على نطاق واسع. لقد تأكدنا أيضًا من أن الإضافة الجديدة ستعيد توجيه عناوين URL من الإضافة القديمة، لذلك لن يؤدي التبديل إلى أي روابط معطلة.
يرجى ملاحظة أن الإضافة الجديدة لا تزال في مراحلها التجريبية. بينما نهدف إلى توفير تجربة سلسة، قد تكون هناك بعض المجالات التي تتطلب مزيدًا من التحسين. ستكون ملاحظاتك البناءة حاسمة لنجاحها.
أخبرنا برأيك
سنقدر أفكارك وتجاربك وملاحظاتك. لا تتردد في مشاركة تجاربك وأي رؤى تجمعها أثناء استخدام إضافة التوثيق الجديدة، سواء عن طريق التنقل عبر التوثيق على Meta، أو تثبيت الإضافة على موقعك الخاص.
هدفنا هو تشكيل تجربة توثيق أفضل لمجتمع Discourse بأكمله، لذا نرحب بجميع الملاحظات!
يجب على شخص ما تحديث ملف القراءة (readme). وربما تحديث قواعد التدقيق اللغوي (lint rules) لمنع حدوث ذلك، على الرغم من وجود مشكلة البيضة/الدجاجة.
يبدو أنه يمكن أن يكون رائعًا أيضًا لاستخدام Discourse كنظام إدارة تعلم (LMS). لهذا، سيكون من الجيد أن نتمكن من تبديل أي فئة هي فئة توثيق، على الرغم من وجود فرصة جيدة لأن يكون استخدام الأذونات لمنح المستخدمين الوصول إلى فئات معينة كافيًا لكي يعمل الأمر بشكل طبيعي.
هل أجرؤ على طلب تقدير للوقت المتوقع؟ أي متى سيتم اعتبار هذه الإضافة أقل تجريبية وأكثر في مرحلة تجريبية، أو ربما حتى مرحلة مرشح الإصدار المبكر؟ أعرف مدى صعوبة التنبؤ بالمستقبل، لذا سأكون سعيدًا بأي تقدير تقريبي، مهما كان غير دقيق.
أنا حاليًا أستكشف Discourse كأداة في العمل، بالضبط لأنه يبدو قادرًا على تقديم مزيج جيد من مناقشات المجتمع ومساحة مشتركة للتوثيق. حيث يسهل كتابة التوثيق بقدر ما يسهل نشر تعليق على موضوع.
لذلك، فإن ميزة موضوع الويكي بحد ذاتها رائعة بالطبع، إنها بداية رائعة. هذه الإضافة، ومع ذلك، تضيف تماسكًا لمحتوى المواضيع، وهو ما أعتقد أنه ضروري لتجربة المستخدم للتوثيق.
تبدو فئة التوثيق على meta.discourse.org الآن كموقع توثيق منظم بشكل صحيح، بدلاً من مجرد بعض مواضيع المنتدى العشوائية التي تشترك في فئة وتصف كيفية عمل Discourse.
أعتقد أن المرحلة التي نحن فيها الآن هي “الجمال (أو عدمه) يكمن في عين الناظر”
إنها تجريبية بمعنى أن هناك مشاكل معروفة في تجربة المستخدم، خاصة بالنسبة للمسؤولين عن صيانة الوثائق وخاصة الفهارس، ولكنها آمنة تمامًا للاستخدام في بيئة الإنتاج.
كل ما سبق يعني أننا نرحب بتعليقاتك بشدة إذا قمت بتجربتها واختبارها بنفسك.
ليس لدينا أي موعد تقديري في هذه المرحلة لتحسين مشاكل تجربة المستخدم المعروفة مع صيانة الفهرس، ولكن التعليقات من الأشخاص الذين يستخدمونها قد تساعد في توجيه المسار هناك.
لا، هذا ليس شيئًا قد ظهر في أي مكان بعد. هل يمكنك مشاركة المزيد حول ما تفكر فيه أو لماذا سيكون هذا مفيدًا لك؟
بخصوص هذا: إذا كنت في فئة مستند، وأغلقت نافذة دردشة غير ممتلئة، فسيتم أيضًا “إغلاق” تنقل المستند وسيظهر شريط التنقل العادي مرة أخرى. أثناء إعادة الإنتاج على ميتا، لاحظت أيضًا أن النقر على فقاعة الدردشة (أعلى يمين الرأس) يؤدي أيضًا إلى إغلاق تنقل المستند. آمل أن يساعد هذا!
هذا يذكرني بشيء واحد بخصوص مشروع Discourse، وهو ليس مثاليًا بالنسبة لي كمستخدم. حقيقة أن المشروع لا يستخدم متتبعًا عامًا للمشكلات للأخطاء والتخطيط.
على سبيل المثال، عندما أقرأ رد هيو، فإن مدير المشروع الداخلي لدي يطرح فورًا السؤال: أين، أين تم تسجيل هذا؟. أعرف، مدير مشروعي الداخلي مخلوق فضولي جدًا، أليس كذلك؟
أفترض أن استخدام meta.discourse.org كمتتبع للمشكلات يمنح المشروع فرصة لـ “dogfooding” (استخدام منتجك الخاص) لـ Discourse. وجميع متتبعات المشكلات الأخرى لها عيوبها الخاصة، لذا من المؤلم الاضطرار إلى اختيار واحدة. ولكن بالنسبة لي، فإن Discourse - بينما هو ممتاز كمنتدى للأسئلة والمناقشات - يفتقر بشدة كمتتبع للمشكلات. لهذا الغرض، يفتقر إلى التصنيف الفعال، والمعلومات حول الإصدارات المتأثرة والمستهدفة، وأرقام المشكلات، وتحديد الأولويات، والوسائل الفعالة لتصفية المشكلات حسب الحالة، والعمر، والأولوية، أو المنتج أو المكونات، وطريقة جيدة لعرض خارطة طريق لميزة أو المنتج ككل، من بين أمور أخرى.
حسنًا، لقد خرجت عن الموضوع. ولم أساهم بسطر واحد من التعليمات البرمجية، أو تقرير خطأ، أو طلب ميزة حتى الآن، فمن أنا لأشتكي.
لذا، مرة أخرى، شكراً لكم جميعاً على روعة Discourse. وأعتذر عن هذا شبه الخطاب.
وعلى الموضوع، يسعدني أن أسمع أن فئات وثائق Discourse، على الرغم من أنها ليست مصقولة بعد، تعتبر مستقرة من الناحية المعمارية. سأتحقق مما إذا كان بإمكاني تثبيتها على نسختي المستضافة من Discourse، وإذا كان الأمر كذلك، سأحاول العودة بملاحظات. شكراً!
نحن نستخدم Discourse كمتتبع للمشكلات. بل قل - أحاول إجبار فريقي على استخدام Discourse كمتتبع للمشكلات وكذلك كويكي، ومنتدى، وتوثيق… أشك في أن فريق CDCK لديه موقع Discourse “سري” آخر يتتبعون فيه شؤونهم داخليًا، باستخدام بعض الإضافات المثيرة للاهتمام، لا يملكها أحد…
بغض النظر عن مدى جودة متتبع المشكلات هنا، لا يمكن مقارنة المجتمع بأي شيء آخر أعرفه. في النهاية، الأشخاص هم من يطورون البرامج، وليس التكنولوجيا الكامنة وراءها. وهم رائعون!
وأنا أحب إضافة التوثيق كثيرًا.
الآن، مع كل ثنائي، هل سيكون من الممكن الموافقة على PR الخاص بي؟
لدينا موقع آخر نستخدمه داخليًا وهذا هو بالفعل كيف نتتبع الكثير من عملنا. لكننا لا نفعل ذلك بأي إضافات سرية.
في الغالب، نستخدم اصطلاحات، مثل فئة لـ “المهام” ومجموعة قياسية من بضع علامات لنوع من تحديد الأولويات الآن/التالي/لاحقًا، إلى جانب إضافة التعيين لتوضيح الملكية.
هذا يمكّن مكون سمة kanban من العمل أيضًا، ولكن لا يستخدم الجميع هذا العرض.
إنه سائل جدًا، وليس متعقب مشاكل ذو رأي قوي، ولكنه يعمل بشكل جيد بالنسبة لنا.
الإضافة الجديدة قيد العمل
الانتقال من إضافة Discourse Docs
أخبرنا برأيك
وكذلك كويكي، ومنتدى، وتوثيق… أشك في أن فريق CDCK لديه موقع Discourse “سري” آخر يتتبعون فيه شؤونهم داخليًا، باستخدام بعض الإضافات المثيرة للاهتمام، لا يملكها أحد…
