DiscourseSkill.md

مطور
6

أتفق معك، وكما ذكرت، كان هذا مسودة أولى وقد تم تحسينها الآن بناءً على ملاحظاتكم. نظرنا مرة أخرى وكنت محقًا.

أُضيف إلى طريقة المراجعة

  • التصنيف المرشح قبل فحص الملفات:

    • إضافة (Plugin)
    • سمة (Theme)
    • مكوّن سمة (Theme component)
    • امتداد هجين (Hybrid extension)
    • مستودع تكامل (Integration repository)
    • عنصر إصدار (Release artifact)

  • قائمة مستودع/إصدار مشترك منفصلة:

    • README، الترخيص، سجل التغييرات
    • ملفات الحزم وملفات القفل (lockfiles)
    • سير عمل CI
    • سكربتات التثبيت/Docker
    • تكاملات الخدمات الخارجية
    • أصول الإصدار المولّدة
    • إصدار مُوسوم/مؤرشف
    • الملفات غير المتتبَّعة والمُتجاهَلة ذات الصلة

  • قائمة الإضافات الموسّعة:

    • كل ملف يُحمَّل، يُسجَّل، أو يُعرَض بواسطة plugin.rb
    • config/routes.rb
    • db/post_migrate/
    • العروض (Views)، المحرّكات (engines)، المُتحقِّقات (validators)، والوسائط (middleware)
    • كود الواجهة الأمامية للإدارة والعامة
    • الموصلات (Connectors)، المكوّنات، المسارات، الخدمات، القوالب، واختبارات الواجهة الأمامية
    • الأنماط المشتركة، وسطح المكتب، والجوال، والإدارة، والمُضمَّنة
    • ملفات الاختبار (Fixtures)، ملفات الدعم، واختبارات المتصفح/النظام
    • تبعيات Ruby، JavaScript، النظام، والخدمات الخارجية
    • .discourse-compatibility
    • فروع d-compat/* وسير العمل
    • حدود إصدار Discourse المُعلَنة

  • قائمة سمة/مكوّن سمة جديدة:

    • about.json في الجذر
    • تصنيف component
    • بيانات الترخيص، المؤلف، الإصدار، والتوافق
    • الأصول، مخططات الألوان، لقطات الشاشة، وإعدادات القابلية للتخصيص المُعلَنة
    • settings.yml في الجذر
    • locales/ في الجذر
    • common/، desktop/، وmobile/
    • ملفات SCSS وملفات حقن HTML المدعومة
    • javascripts/ في الجذر
    • api-initializers/
    • جميع ملفات .js و.gjs و.hbs
    • stylesheets/ في الجذر وأوراق الأنماط المستوردة
    • assets/ في الجذر وجميع المراجع إليها
    • المعاينات/لقطات الشاشة
    • الاختبارات وإعدادات التدقيق/البناء (lint/build)
    • بيانات التوافق والفروع
    • بايتات السمة المُعبَّأة/المُصدَرة

  • فحوصات هيكلية جديدة:

    • يجب أن يتطابق نوع الامتداد المُعلَن مع about.json وسلوك التثبيت.
    • component: true تعني مكوّن سمة.
    • component: false أو الإغفال تعني سمة كاملة.
    • تحصل المستودعات الهجينة على كل قائمة تنطبق عليها.
    • تُفحص الملفات الموضوعة في مكان غير صحيح أو غير متوقعة بدلاً من تجاهلها بصمت.
    • المجلدات الاختيارية المفقودة ليست عيوبًا تلقائيًا.
    • شجرة العمل، أرشيف الإصدار، الامتداد المثبَّت، الأصول المولّدة، والمرشح العام هي أسطح أدلة منفصلة.

  • قائمة سمة كاملة جديدة:

    • هوية البيانات الوصفية
    • عرض السمة الكاملة
    • تغطية الصفحات الأساسية
    • الإعدادات، اللغات، والأصول
    • JavaScript/API initializers المدعومة
    • السلوك المتجاوب، إمكانية الوصول، وRTL
    • سلوك Foundation وHorizon والتضمين
    • تفاعلات مكوّنات السمة
    • فحوصات التثبيت، التحديث، التراجع، والتوافق

آمالي هي أن تؤدي مدخلات المجتمع إلى تحسين المهارة (Skill)، وأن تساعد المهارة الآخرين في تقييم عملهم الخاص أو، بصراحة، عمل الآخرين قبل التثبيت إذا كان هناك شك في الجودة.

حتى الآن، لدينا انتصاران من أصل اثنين. أدت ملاحظاتكم إلى تحسينات في المهارة، وجد @satonotdead أنها مفيدة. شكرًا على كلماتكم اللطيفة ودعمك @satonotdead