آناتومی یک گزارش خطای خوب

به مشکلی در مدل خود برخورد کرده‌اید؟ خطایی را دریافت کرده‌اید؟ تحلیل یا طراحی مدل کامل نمی‌شود یا به اتمام نمی‌رسد؟ برنامه آنطور که مد نظر شماست رفتار نمی‌کند؟ برای طرح این مسائل، صرف عنوان کردن «برنامه کار نمی‌کند» یا «خطا می‌ده» منزلت خودتان را تا حد یک کاربر عادی تازه کار و یک اپراتور کاملا مبتدی، تنزل داده‌اید. در ادامه، ساختار یک گزارش خطای خوب را بررسی خواهیم کرد تا شما را سریعتر به مقصودتان برساند.
 
کارهای لازم پیش از پرسش
- سعی کنید انجمن‌های مرتبط را یکبار بررسی و جستجو کنید. پرسش‌های مشابه را در کانال جستجو و بررسی کنید.
- گوگل  اختراع شده است. عین خطای دریافتی را در گوگل جستجو کنید. هنگامیکه با برنامه‌ای مانند ETABS  یا SAFE  یا SAP2000  یا امثال آنها کار می‌کنید، یعنی «تنها نیستید». یقین داشته باشید خطایی را که دریافت کرده‌اید، پیشتر توسط ده‌ها نفر دیگر در سایت‌ها یا انجمن‌ها مختلف مطرح شده‌اند و بالاخره با بررسی آن‌ها می توان به پاسخ رسید.
- راهنمای برنامه و قسمت ویکی سایت را بررسی کنید. شاید مطلب خاصی را در خصوص مورد شما عنوان کرده باشد.
 
کجا باید سوال پرسید؟
- اگر پاسخی دریافت کردید، ادامه‌ی بحث را ذیل همان مطلب پیگیری کنید.
- اگر تا نیم ساعت!! بعد جوابی دریافت نکردید، انجمن یا کانال یا کل بخش‌های سایت را با ارسال پیام خود اسپم نکنید. یکبار ارسال پرسش کافیست. پرسشتان را مطرح کنید. اگر شخصی قادر به پاسخ‌دهی بود، به شما کمک خواهد کرد. بنابراین اگر سریعا به جواب نرسیدید،  نه کل انجمن، سایت یا کانل را اسپم کنید و نه شروع به رفتارهای ناشایست کنید. این کار با فریاد کشیدن وسط یک جمع تفاوتی ندارد. اشخاص مرتبط همواره آنلاین نیستند. ضمنا ممکن است واقعا پاسخی برای یک پرسش نداشته باشند. منصف باید.
- از ایمیل‌های خصوصی افراد یا قسمت پیام‌های خصوصی برای ارسال پرسش‌های شخصی استفاده نکنید. این بخش‌ها مخصوص کارهای شخصی‌ست. این تصور را نداشته باشید که اشخاص، مشاور شخصی رایگان پروژه‌های شما هستند.
 
چطور باید سوال پرسید؟
سوال فنی خوب پرسیدن یک هنر است که تعدادی از مشخصه‌های مهم آنرا در ذیل مرور خواهیم کرد:
- عنوان مناسبی را برای سؤال خود انتخاب کنید. «لطفا کمک کنید» یا «من مشکل دارم» یا «مشکل در پروژه»، عموما واکنش‌های تندی را به همراه دارند؛ و تا حد ارسال اسپم، بی‌کیفیت تلقی می‌شوند. ضمن اینکه انتخاب عنوان‌های مناسب، جستجوهای بعدی را در ساده می‌کنند و کمک بزرگی خواهند بود به افراد بعدی.
- محیط یا برنامه‌ای را که خطا در آن رخ داده است، توضیح دهید.
- حتما کل خطای دریافت شده را ارسال کنید. همین مساله می‌تواند به خطایابی نهایی بسیار کمک کند.
- سؤال خود را طوری مطرح کنید که شخص مقابل بتواند آن‌را در کمترین زمان ممکن «باز تولید» کند. برای مثال ذکر خطای دریافتی بسیار خوب است. اگر داده‌ای که سبب بروز این خطا شده است را هم ارسال کنید، مفید‌تر خواهد بود. صرفا عنوان نکنید که جواب نگرفته‌اید. چه دستوری را اجرا کرده‌اید؟ چه خطایی را دریافت کرده‌اید؟ ساختار پروژه شما چیست؟ آیا شخص مقابل می‌تواند بر اساس اطلاعاتی که ارائه دادید یک آزمایش شخصی را تدارک ببیند؟ آیا می‌تواند آن‌را با توضیحات شما مجددا تولید کند؟
- زمان باز تولید خطا را هم مدنظر داشته باشید. برای مثال اگر بتوانید مدلی را ارائه دهید که در کمترین زمان ممکن، صرفا با کپی و پیست آن قابل کامپایل باشد، بسیاری علاقمند به پاسخگویی به شما خواهند شد. در غیراینصورت آنچنان انتظار نداشته باشید که شخص پاسخ دهنده وقت زیادی را برای رسیدگی به جزئیات سؤال شما صرف کند؛ یا مدتی مشغول به تهیه یک مثال جدید بر مبنای توضیحات شما شود.
- حجم کدهای ارسالی شما نیز در اینجا مهم هستند. کل پروژه خود را ارسال نکنید! سعی کنید یک مثال کوچک را که بتواند سریعا خطای مدنظر شما را بازتولید کند، ارسال کنید و نه بیشتر.
- و به صورت خلاصه، خودتان را بجای پاسخ دهنده قرار دهید. آیا با چند جمله‌ای که ارائه داده‌اید، می‌توان انتظار پاسخی را داشت یا خیر.
- ایمیل شخصی خود را در انتهای پیام ارسال نکنید. کسی اهمیتی نمی‌دهد! اگر سؤال شما پاسخی داشته باشد، همانجا دریافت خواهید کرد و نه در میل باکس شخصی.
- املاء و انشای متنی را که ارسال می‌کنید، یکبار بررسی کنید. اگر برای شما اهمیتی ندارد که چه کلمات و جمله بندی را باید بکار برد، برای شخص مقابل هم آنچنان اهمیتی نخواهد داشت که زیاد وقت صرف کند.
- از بکار بردن smileyهای بیش از حد یا قرار دادن تعداد علامت تعجب‌های بیش از حد خودداری کنید. این موارد عموما به مسخره کردن شخص مقابل تفسیر می‌شوند.
- هدف از کاری را که مشغول به انجام آن بود‌ه‌اید را نیز ذکر کنید. ذکر خطای دریافتی بسیار مفید است اما اگر بتوانید یک دید کلی را نسبت به کاری که مشغول به آن بوده‌اید، ایجاد کنید، شاید پاسخ بهتری را دریافت کنید. برای مثال جهت رسیدن به هدف و مقصود شما بهتر است از روش دیگری استفاده کنید.
- در بدو امر فریاد نکشید که «باگ» پیدا کرده‌اید؛ خصوصا اگر به mailing list اختصاصی یک پروژه پیامی را ارسال می‌کنید. چون اگر مشکل شما واقعا باگ نباشد، بیشتر یک توهین تلقی خواهد شد و در دفعات بعدی پاسخ دادن به شما به صورت ضمنی مؤثر خواهند بود؛ یا جواب نمی‌گیرید و یا جدی گرفته نخواهید شد.
- پس از اینکه پیامی را دریافت کردید، یک حداقل واکنشی را ارسال کنید. مثلا خوب بود؛ کمک کرد و یا مفید نبود. همین واکنش‌ها در آینده به کمک نتایج جستجوهای انجام شده خواهند آمد و اشخاص بعدی حداقل خواهند دانست که پاسخ داده شده صحیح بوده است یا خیر.
 
و همیشه بخاطر داشته باشید: تمام خدماتی که سایت‌های عمومی به شما ارائه می‌دهند «یک لطف» است و حقی را برای شما ایجاد نمی‌کنند. این اشخاص از شما پول نمی‌گیرند تا به سؤالات شما پاسخ دهند یا تبدیل به مشاور خصوصی رایگان شما شوند. می‌توانید محیط را برای این اشخاص، با اندکی احترام، ملایمت و انصاف، دلپذیرتر کنید.
 
از وب سایت مهندس نصیری 

مقالات مرتبط

برچسب‌ها: طرح مشکلات و دریافت کمک
آدرس کوتاه:
اولین دیدگاه را شما ارسال کنید.