المقالات

تعلّم كيف تكتب المقالات للتمارين


يمكن أن يكون لكل تمرين مقالات مرتبطة به، تستكشف جانبًا مثيرًا للاهتمام من التمرين.

الموضوعات

الموضوعات المحتملة التي يمكن للمقال أن يستكشفها:

  • مقارنة أداء الأساليب المختلفة
  • أي شيء مثير للاهتمام يخطر ببالك!

اعتبارات عامة

  • إذا كان مقالك قائمًا على كود كتبته، ففكّر في تسجيل ذلك الكود (داخل مجلد المقال)
    • ومن الأمثلة على ذلك مقال عن الأداء كُتب له كود لقياس الأداء

ما التمارين التي تُكتب لها المقالات؟

أي تمرين، طالما هناك شيء مثير للاهتمام يمكن استكشافه.

الملفات

على كل مقال أن يضيف الملفين التاليين:

  • .articles/<article-slug>/content.md: وصف المقال (راجع الوثائق)
  • .articles/<article-slug>/snippet.md: مقتطف يعرض المقال (راجع الوثائق)

بعد ذلك ستحتاج إلى إضافة أو تحديث:

  • .articles/config.json: البيانات الوصفية للمقالات (راجع الوثائق)