مقالات البرمجيات البحثية والاستعداد لـ JOSS

افصل البرنامج عن مقاله

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

تتناول تعليمات JOSS الحالية ستة أشهر على الأقل من التطوير العام النشط؛ الرفع المفاجئ لمشروع خاص لا يعادل هذا التاريخ. قدم دليلاً على الاستخدام العلمي والنضج وافحص الشروط عند التقديم.

ملف استعداد قابل للفحص

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

سجل روابط الأدلة وحالتها. حدد العقد أو الخطأ العلمي الذي يفحصه كل اختبار؛ نجاح CI وحده لا يثبت صلاحية المنهج.

اختبارات علمية

مثال: متوسط [2,4,6] يجب أن يساوي 4 ويرفض الإدخال الفارغ صراحة. اختبر الانحدار ببيانات ذات معامل معلوم ومقارنة مستقلة؛ نسخ التنفيذ في الاختبار ليس دليلاً مستقلاً.

غط الحدود والمفقود والوحدات والنسخ. المثال القابل للتنزيل هنا تعليمي ولا يقدم كبرنامج مؤهل لـ JOSS.

المقال والاستشهاد والنسخة

اشرح المشكلة والمستخدمين والأدوات المشابهة والتصميم والحاجة بمراجع حقيقية. ثبت إصدار الكود وطريقة الاستشهاد به واذكر الاعتماديات.

وضح المساهمات والصيانة وأدلة الاستخدام العلمي. النجوم والتنزيلات لا تثبت وحدها استخداماً بحثياً موثوقاً.

AI وتواصل المراجعة

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

يجب أن يشرح المؤلف المنطق والترخيص والأمن والسلوك ويصححه. القابلية للتنفيذ لا تثبت الموثوقية؛ احتفظ بمراجعة بشرية واختبارات مفيدة.

نموذج تعليمي مكتمل

هذه حالة تعليمية افتراضية وليست بيانات مرصودة أو مراجعة أو قبولاً حقيقياً. الأرقام لتوضيح القرارات.

المخرجات وفحص الاكتمال

• جدول استعداد بأدلة فعلية.
• اختبارات وتوثيق تثبيت وإصدار ثابت.
• مسودة وتصريحات مساهمة وAI وفق السياسة.

مراجع النسخة والنطاق: JOSS — Submission requirements and AI policy · Cornell Data Services — Writing READMEs for Research Data