- جدول آمادگی با پیوند شواهد واقعی.
- آزمون علمی، مستند نصب و انتشار نسخه‌دار.
- پیش‌نویس مقاله و اظهار سهم/AI مطابق سیاست جاری.
نرم‌افزار را از مقالۀ آن جدا کنید
مقالۀ کوتاه نمی‌تواند کمبود نرم‌افزار را جبران کند. ابتدا توضیح دهید ابزار برای چه مسئلۀ پژوهشی، چه کاربرانی و چه ورودی/خروجی‌ای ساخته شده و چه تفاوت مشخصی با ابزارهای موجود دارد.
در سیاست جاری JOSS سابقۀ توسعۀ فعال عمومی دست‌کم شش ماه مطرح است؛ انتقال ناگهانی کد خصوصی به یک مخزن تازه همان سابقه نیست. کاربرد پژوهشی و بلوغ پروژه باید با مدارک واقعی نشان داده شود. شروط جاری را هنگام ارسال دوباره بخوانید.
پروندۀ آمادگی قابل ارزیابی
مجوز سازگار، نصب روشن، آموزش شروع، مثال واقعی قابل تکرار، آزمون خودکار، راهنمای مشارکت و راه ارتباط برای اشکال‌ها تهیه کنید. یک اسکریپت کلاسی کوچک یا ابزار تک‌کارۀ جزئی را خودکار واجد شرایط JOSS ندانید.
جدول شواهد با پیوند فایل و وضعیت بسازید. عبارت «تست دارد» مبهم است؛ نشان دهید آزمون چه قرارداد ورودی/خروجی یا خطای علمی را کنترل می‌کند. نشان سبز CI به تنهایی صحت روش را اثبات نمی‌کند.
آزمون علمی به جای آزمون ظاهری
مثال آموزشی: تابع میانگین باید برای [2,4,6] مقدار 4 بدهد و ورودی خالی را صریح رد کند. برای تحلیل رگرسیون، داده مصنوعی با ضریب معلوم و مثال مستقل مقایسه‌ای به کار ببرید؛ فقط اجرای همان تابع در آزمون، شاهد مستقل نیست.
مرزها، داده گمشده، واحد و تغییر نسخه را پوشش دهید. کاربر باید بداند خروجی نامعتبر چه زمانی تولید نمی‌شود. مثال دانلودی این سایت کوچک و آموزشی است و به عنوان نرم‌افزار واجد شرایط JOSS معرفی نمی‌شود.
مقاله، استناد و نسخه
شرح مسئله، کاربران، وضعیت ابزارهای مشابه، طراحی و نیاز پژوهشی را با ارجاع واقعی بنویسید. انتشار مشخص کد را نسخه‌گذاری و راه استناد به همان نسخه را توضیح دهید؛ تاریخ و وابستگی‌ها را پنهان نکنید.
سهم نویسندگان و نگهداری آینده را روشن کنید. کد را با شواهد استفاده علمی واقعی همراه کنید؛ ستاره مخزن یا دانلود به تنهایی معادل استفاده معتبر پژوهشی نیست.
استفاده از AI و تعامل داوری
طبق سیاست جاری JOSS استفاده از AI در توسعۀ نرم‌افزار نیازمند شرح ابزار، نسخه، دامنه و بررسی انسانی است. در گفت‌وگو با سردبیر و داور، محدودیت سیاست جاری بر متن AI را نیز بخوانید؛ استثنای ترجمه با تولید پاسخ خودکار یکسان نیست.
نویسنده باید بتواند منطق، مجوز، امنیت و رفتار کد را توضیح و اصلاح کند. خروجی قابل اجرا با کد قابل اعتماد یکی نیست؛ بازبینی و آزمون را به نام یک ابزار واگذار نکنید.
نمونۀ تکمیل‌شده برای تمرین
این پرونده فرضی است؛ داده، داوری یا پذیرش واقعی را گزارش نمی‌کند. اعداد فقط برای توضیح تصمیم‌اند.
| تصمیم یا سند | نمونۀ آموزشی | کاری که برای پروژه خود انجام می‌دهید |
|---|---|---|
| نیاز | ابزار تحلیل برای یک سؤال علمی مشخص | کاربر و ابزار جایگزین را توضیح دهید. |
| تاریخچه | مثال آموزشی فاقد سابقۀ لازم JOSS | پیوند توسعۀ واقعی و مدت را ثبت کنید. |
| آزمون | میانگین و رگرسیون با جواب معلوم | فهرست قراردادها و خطاها را بنویسید. |
| مستند | نصب، مثال، مجوز و مشارکت | از محیط پاک نصب را بازبینی کنید. |
| افشا | ابزار کمکی و بازبینی انسانی | سیاست دقیق مجله را اعمال کنید. |
خروجی و معیار پایان کار
- جدول آمادگی با پیوند شواهد واقعی.
- آزمون علمی، مستند نصب و انتشار نسخه‌دار.
- پیش‌نویس مقاله و اظهار سهم/AI مطابق سیاست جاری.
مرجعِ نسخه و دامنه: JOSS — Submission requirements and AI policy · Cornell Data Services — Writing READMEs for Research Data
منابع و مطالعه بیشتر
منابع رسمی برای بررسی و مطالعه بیشتر