رفتن به محتوا
سارویتوسعه‌دهندگان
مستندات/ابزارهای توسعه

نمونهٔ کارهای واقعی

درخواست‌های قابل اجرا با نتیجهٔ روشن و قابل بررسی.

۱. شناخت یک پوشه

از پوشهٔ هدف ساروی را اجرا کن و بنویس:

فایل‌های همین پوشه را بررسی کن. نام، نوع و کاربرد احتمالی هرکدام را در یک جدول خلاصه کن. هیچ فایلی را تغییر نده. اگر چیزی را نمی‌دانی، مشخص کن.

نتیجه را با فهرست فایل‌های واقعی مقایسه کن. برای کار با فایل‌های بسیار بزرگ، پوشه یا فایل‌های مشخصی را انتخاب کن تا محتوای غیرضروری به مدل ارسال نشود.

۲. ساخت گزارش از چند سند

سه فایل گزارش در پوشهٔ reports را بخوان. نکته‌های مشترک، اختلاف‌ها و کارهای بعدی را در summary.md بنویس. منبع هر نکته را با نام فایل مشخص کن. پیش از نوشتن، ساختار پیشنهادی را نشان بده.

بعد از تأیید، فایل خروجی را باز و ارجاع‌ها را بررسی کن. صرف توضیح عامل دربارهٔ ساخت فایل کافی نیست؛ خود فایل باید موجود باشد.

۳. پژوهش در مرورگر

دربارهٔ موضوع مشخص‌شده از سه منبع اصلی جستجو کن. تاریخ و نشانی هر منبع را نگه دار و نتیجه را در research.md خلاصه کن. اگر صفحه قابل دسترس نبود، آن را صریح بنویس.

بررسی کن ابزار مرورگر واقعاً آماده باشد. برای اطلاعات وابسته به زمان، تاریخ مشاهده و تاریخ انتشار را در درخواست بخواه.

۴. اصلاح یک پروژهٔ کد

این پروژه را بررسی کن. ابتدا روش اجرا و تست را پیدا کن، سپس علت خطای توضیح‌داده‌شده را مشخص کن. تغییر را کوچک نگه دار، تست مرتبط را اجرا کن و در پایان فایل‌های تغییرکرده و نتیجهٔ تست را بگو.

قبل از کار، تغییرهای مهمت را ذخیره کن. یک پوشهٔ پروژه هدف مناسبی است؛ اجرای عامل از ریشهٔ رایانه با درخواست مبهم کار را دشوارتر می‌کند.

۵. کار با یک برنامه

برنامهٔ موردنظر را ببین و محل گزینهٔ Export را پیدا کن. فعلاً فقط مسیر را توضیح بده. پیش از ذخیره یا ارسال چیزی، از من اجازه بگیر.

این کار به مدل دارای دریافت تصویر و مجوزهای کنترل برنامه نیاز دارد. برنامهٔ هدف را آماده نگه دار. بعضی پنجره‌های محافظت‌شده یا دارای سطح دسترسی بالاتر قابل کنترل نیستند.

۶. تغییر دسته‌جمعی با امکان بازبینی

پیشنهاد بده این فایل‌ها چطور نام‌گذاری شوند. جدولی از نام فعلی و نام پیشنهادی بساز و هیچ فایلی را هنوز تغییر نده. پس از تأیید من، فقط همین تغییرها را انجام بده.

درخواست خوب چه دارد؟

مسیر یا برنامهٔ هدف، نتیجهٔ مورد انتظار، قالب فایل خروجی و محدودیت‌های مهم را مشخص کن. برای کار طولانی، نقطهٔ بررسی بخواه. بعد از پایان، نتیجه را در فایل، مرورگر یا برنامهٔ واقعی باز کن؛ متن پاسخ به‌تنهایی اثبات انجام کار نیست.

قرارداد API 1.6.0 · تاریخچهٔ تغییرات