كيف يمكننا تنظيم #howto بشكل أفضل؟

لدينا مجموعة كبيرة من الأدلة، وأحيانًا يشارك @dax أو @jomaxro دليل howto لم أكن أعرف بوجوده فأكون منبهرًا!

لاحظت أيضًا أن هذا الأمر ينطبق على العديد من المستخدمين الجدد ومديري المجتمعات في Discourse هنا في Meta. لذا، وبهدف حل هذه المشكلة، توصل @justin إلى فكرة رائعة لتجميع أدلة الـ howto لدينا وتوفير نقطة انطلاق أفضل للجميع، ونأمل أن نصل إلى شيء مشابه لـ https://support.teams.discourse.com/docs

أنا حاليًا أفكر في ثلاث مجموعات:

  • البدء
  • المساهمة (بما في ذلك دروسنا وأدلةنا حول الإضافات والمظاهر)
  • التكوين

أي من أدلة الـ howto تعتقد أنها تنتمي إلى كل مجموعة؟

أود جدًا سماع أفكاركم :smiley::heart:

13 إعجابًا

لا أعتقد أنك ستحصل على أي ردود هنا، لأنه لا يوجد حافز للناس لتولي هذا العمل.

إما أن نعينه لفريقنا، أو نحتاج إلى إيجاد طريقة لتبسيطه (ربما باستخدام الوسوم؟).

6 إعجابات

هناك الكثير منها :sweat_smile:

11 إعجابًا

يبدو أنني كنت مخطئًا! شكرًا لك. :slight_smile:

7 إعجابات

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

@osioke – إحدى الطرق للتعامل مع هذا الأمر هي البحث عن أدلة تعليمية الأكثر مشاهدة والتي تتوافق مع هذه الفئات واختيار أفضل 6-12 دليلًا من حيث المشاهدات لوضع العلامات عليها. سيكون ذلك نقطة انطلاق سهلة مقترنة باقتراحات @بنجامين_دي هنا!

جمالية العلامات تكمن في أنه يمكننا تعديلها بسهولة أثناء تقدمنا أيضًا.

7 إعجابات

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

أنا الآن أعمل على توسيع التجميع من 3 إلى 6 أقسام:

  • البدء
  • الإعداد
  • الإعداد المتقدم
  • المساهمة
  • التكوين
  • التكوين المتقدم

ومثلما شارك @justin، بعد النظر في الأكثر مشاهدة، لدي أول 20 رابطًا:

ما رأيكم؟

سيكون هذا تغييرًا كبيرًا، لذا اسمحوا لي باستدعاء الخبراء وإشعار: @trust_level_3

9 إعجابات

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

7 إعجابات

لست متأكدًا مما إذا كان يجب ذكر متعدد المواقع هنا :thinking:، أو ربما يمكن أن تأتي مجموعة الإعدادات المتقدمة مع تحذير، ابحث في الميتا! على سبيل المثال، هذا المنشور مفيد جدًا pros-and-cons-of-a-multisite-installation.

بخصوص إرسال دعوات جماعية للمستخدمين، أميل الآن إلى استخدام روابط الدعوة متعددة الاستخدامات، ربما نذكر كلا الموضوعين؟

أعتقد أنني سأضع إعداد الرد عبر دعم البريد الإلكتروني :envelope: في مجموعة الإعدادات المتقدمة (لأنني لم أفعل ذلك بعد :see_no_evil:)، و تسليم البريد الوارد المباشر والمباشر يستحق الذكر ربما في مجموعة الإعدادات المتقدمة، لأن … حسنًا … البريد الإلكتروني :scream:.

تبدو مجموعة المساهمين فارغة بعض الشيء، ربما يكون شيء متعلق بالموضوعات أو المكونات لطيفًا، مثل دليل المطورين لموضوعات discourse، دليل المصممين لموضوعات discourse، و دليل المبتدئين لاستخدام منشئ الموضوعات وواجهة سطر الأوامر للموضوعات لبدء بناء موضوع discourse

3 إعجابات

صحيح، القائمة مستندة إلى أكثر 20 موضوعًا مشاهدةً، وقد شاركتها لأوضح تفكيري في ترتيبها. إنها ليست القائمة النهائية بأي حال، كان يجب أن أكون أكثر وضوحًا قليلاً :sweat_smile:

3 إعجابات

أود أن أرى “الإدارة” أو “العمليات” كفئة للأنشطة الإدارية والمُعدّلة المستمرة. لا تتناسب مع الإعداد/التهيئة وليست تطويرًا/توثيقًا (المساهمة).

إعجابَين (2)

أفترض أن موقع وثائق Discourse للفرق يستخدم Discourse لجميع الوثائق. المشكلة في ذلك لموقع تعليمي حول Discourse حيث يمكن لأي شخص من المجتمع المشاركة هي إدارة الإصدارات وتتبع كل شيء. أنا متأكد من أن استخدام Discourse لهذا الغرض هو الطريقة المفضلة، لكن هل لي أن أقترح ربما موقع Hugo أو موقع Jekyll، بحيث تكون الوثائق ملفات في مستودع GitHub يمكن لأي شخص تقديم طلبات دمج (PRs) إليها. إذا لم يعجبك أي من هذين الخيارين، فهناك العديد من أنظمة توثيق مستودعات GitHub الأخرى المتاحة بأنواع مختلفة.

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

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

هذا يبدو معقولاً جدًا، هل يمكنك مشاركة بعض المنشورات التي تناسب هذا التصنيف؟

إعجابَين (2)

مجرد معلومة، كنت أعمل ببطء على تنظيف قسم #howto:sysadmin، والتأكد من أن كل منها محدث وذو صلة، ثم نقلها إلى auto-delete-posts-after. يبدو أن معظمها تم تصنيفه هنا على أنه advanced config.

7 إعجابات

أتفق تمامًا. تعدد المواقع هو إعداد متقدم للغاية وليس شيئًا ندعمه كثيرًا في الميتا.

بالضبط. ديسكورت + إضافة الوثائق + بعض التخصيصات الإضافية. استخدام ديسكورت هو تفضيلنا في هذا الشأن، لكنني أرى فوائد استخدام موقع ويكي/SSG أيضًا.

شكرًا جزيلًا لك على القيام بذلك :heart:

6 إعجابات

سيكون رائعًا لو انتقلت المواضيع “الأقل دعمًا” إلى فئة خاصة بها ومُعلَّمة بوضوح.

يبدو أن هناك عقلية سائدة حاليًا مفادها أنه إذا كُتب شيء هنا، فإن الدعم مُستحق بطريقة ما.

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

هل تندرج المجلدات الفرعية، وتعدد المواقع، والفئات الثانوية ضمن هذه الفئة، أليس كذلك؟

6 إعجابات

أعتقد أن المواقع المتعددة مدعومة إلى حد كبير لكن يُتوقع أنه إذا سلكْتَ هذا المسار، فستكون لديك معرفة بأن الأمر يتطلب منك المزيد (على سبيل المثال، تحتاج إلى التفكير في معنى أمر rebuild app في سياقات مختلفة). سأقول إنها “متقدمة”، لكنها ليست “متقدمة للغاية للغاية”.

أتفق على أن الفئات من الدرجة الثالثة والمجلدات الفرعية “متقدمة للغاية للغاية”.

4 إعجابات

ربما أفكر أكثر في المواقع المتعددة مع Let’s Encrypt، والتي تعطلت مرارًا وتكرارًا على مر السنين، وأحيانًا استغرقت الوثائق المحدثة أسابيع أو أشهر لتظهر.

4 إعجابات

آه، نعم. أعتقد أن هذا الأمر مستقر إلى حد كبير الآن (أعتقد أن آخر تغيير كان يتعلق بكيفية معالجة إعادة التوجيه في nginx)، ولدي رابط Multisite Configuration with Let's Encrypt and no reverse proxy - Documentation - Literate Computing Support أعتزم نشره هنا قريبًا جدًا (لقد كتبته واختبرته آخر مرة في 2 ديسمبر 2020). لكن multisite تعني بالتأكيد أنك ستعتمد على نفسك إلى حد كبير. لا أعتقد أن لها معنى إلا إذا كان لديك 3 مواقع على الأقل (ربما 10؟)، لأن معظم الأشخاص الذين يعتقدون أنهم يريدونها يحاولون الاعتماد على خادم واحد بسعة 1 جيجابايت.

4 إعجابات

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

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

في الوقت الحالي، تقررون عمليًا إعداد المنتدى في الوثائق:

لماذا لا يستخدم الموظفون وسومًا مخصصة للموظفين فقط لتنظيم وهيكلة الوثائق، مثل ‘docs-getting-started’، ‘docs-setup’ - مع محتوى من أي مكان في المنتدى؟ ثم يمكنكم إعداد صفحة وثائق تكون أكثر من مجرد مرآة للمنتدى، بل تحتوي على جدول محتويات منسق بعناية، مثل:

الوثائق
+البدء
+الإعداد
+الإعداد المتقدم
+المساهمة
+التكوين
+التكوين المتقدم

إعجابَين (2)

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

6 إعجابات