إعادة توثيق الهيكل لتحسين الوضوح

:white_check_mark: تحديث (4 يونيو 2024): تم الانتهاء من العمل الأولي لإعادة هيكلة مواضيع التوثيق، والفئات الجديدة أصبحت متاحة الآن مع فهرس جديد يوضح ما ستجده فيها. يمكنك الاطلاع عليها هنا: Documentation - Discourse Meta - إذا لاحظت أي شيء يبدو غير صحيح، يرجى النشر أدناه!

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

ما يمكن توقعه

:label: فئات جديدة

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

:eyes: تغييرات بصرية مؤقتة

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

:white_check_mark: تحديثات شاملة

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

كيف يمكنك المساعدة

ملاحظاتك، كما هو الحال دائماً، لا تقدر بثمن بالنسبة لنا. إذا صادفت أي مشاكل أو لديك اقتراحات حول كيفية تحسين توثيقنا أكثر، فلا تتردد في مشاركة أفكارك في Contribute > Site feedback أو كنشر على هذا الموضوع.

شكراً لصبركم أثناء إجراء هذه التغييرات!

14 إعجابًا

المواضيع المتعلقة بالإشراف مثل Discourse Moderation Guide هي جزء من Documentation > Site Management. ربما يجب إضافة ذلك إلى الوصف لأنه بصفتي مشرفًا، لن أبحث في مواضيع فئة “لمالكي الموقع ومديريه”.

3 إعجابات

لقد أجريت تعديلاً بسيطًا على نص “حول” للإشارة إلى أنه مفيد أيضًا للمشرفين.

قد يكون لدى @JammyDodger و/أو @hugh أفكار إضافية عند رؤية هذا لاحقًا أيضًا.

إعجابَين (2)

لقد قمت بإجراء تعديل إضافي عليه:

4 إعجابات

شكراً لتسليط الضوء على هذا @Moin!

@JammyDodger يبدو تحديثك جيداً بالنسبة لي.

تم الانتهاء من العمل الأولي لإعادة هيكلة مواضيع التوثيق، والفئات الجديدة متاحة الآن مع فهارس جديدة توضح ما ستجده فيها.

يمكنك الاطلاع عليها هنا: Documentation - Discourse Meta - إذا لاحظت أي شيء يبدو غير صحيح، فيرجى النشر أدناه!

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

هل تخطط لإضافة الفئات الجديدة إلى المكوّن الإضافي للمستندات؟

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

نحن في حيرة بين تجربة الحياة بدون إضافة المستندات أو عدم تجربتها. :slight_smile: في الوقت الحالي، أضفت الفئات الجديدة إلى المزيج. :+1:

3 إعجابات

تم دمج مشاركة في موضوع موجود: تحسين التنقل في التوثيق بشريط جانبي جديد

هل يمكنني معرفة كيف يتم إنشاء نص الروابط للمواضيع في الشريط الجانبي عند التواجد في فئة فرعية؟ الذكاء الاصطناعي؟

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

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

3 إعجابات