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

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

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

ما يمكن توقعه

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

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

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

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

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

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

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

ملاحظاتك، كالعادة، لا تقدر بثمن بالنسبة لنا. إذا واجهت أي مشاكل أو كانت لديك اقتراحات حول كيفية تحسين توثيقنا بشكل أكبر، فلا تتردد في مشاركة أفكارك في 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 إعجابات