چگونه باگ‌ها را گزارش دهیم؟

باگ چیست؟

یکی از مفاهیم جالب و در عین حال پیچیده در دنیای نرم‌افزار (گرچه در سایر علوم هم کاربرد دارد)، مفهوم باگ (Bug) یا به طور ساده نقص نرم‌افزاری است. احتمالا می‌دانید به اشکالات نرم‌افزاری اصطلاحا باگ اطلاق می‌شود ولی واقعا چرا نرم‌افزارها باگ دارند؟ و چرا هیچ وقت شر این باگ‌ها حتی با ارائه انواع و اقسام آپدیت‌ها از سر ما کم نمی‌شود؟ مفهوم باگ، این واقعیت مهم را برای انسان روشن کرده است که هیچ فرمول و قانون مخلوق دست انسان، بی اشکال و کمبود نیست و در هر طرح و برنامه‌ای بدون تردید نقصان‌ها و لغزش‌هایی وجود دارد که در نگاه اول به نظر نرسیده‌اند. رفع باگ‌ها تقریبا مثل حل کردن معماست و برای بسیاری از برنامه‌نویسان یکی از قسمت‌های چالش برانگیز و لذت‌بخش کار است.

تعریف واژه باگ

bug

باگ از نظر لغوی یعنی حشره کوچک و در تاریخ مهندسی نرم‌افزار گفته می‌شود این اصطلاح را اولین بار گریس هوپر خانمی که در دانشگاه هاروارد مشغول تحصیل و تحقیق در رشته کامپیوتر بود، به کار برده است. او در حال کار با کامپیوتر یک بار با مشکل مواجه شد و تکنسین‌هایی که برای بررسی مشکل و تعمیر کامپیوتر، آن را باز کرده بودند سوسکی را پیدا کردند که وارد دستگاه شده بود و آن را از کار انداخته بود و بدین ترتیب اولین بار واژه باگ به شوخی مورد استفاده قرار گرفت. اعتقاد بر این است که اصطلاح Debugg (اشکال‌زدایی) نیز توسط همین افراد ابداع شد.

باگ اشکالی است که در یک برنامه رخ داده و باعث از کار انداختن کلی آن یا اجرا نکردن دستور یا دستورات بعدی به صورت ناقص یا کامل می‌گردد. اغلب این مشکلات در هنگامی رخ می‌دهد که داده‌های دریافتی از سوی کاربر فیلتر نشده و برنامه سعی به اجرا کردن آن می‌کند برای نمونه می‌توان انجام عمل تقسیم را بیان کرد. فکر کنید برنامه دو متغیر را دریافت می‌کند به طوری که متغیر اول عدد صورت و متفیر دوم عدد مخرج می‌باشد اگر کاربر ابتدا عدد ۶ و سپس عدد ۳ را وارد کند برنامه در خروجی خود عدد ۲ را نمایش خواهد داد حال اگر کاربر در صورت یک عدد (مثلا ۶) و در مخرج یک حرف الفبا یا عدد صفر را وارد کند به نظر شما عکس‌العمل برنامه چه خواهد بود؟
همانطور که می‌دانیم در ریاضیات تقسیم عدد بر حروف الفبا و صفر تعریف نشده است پس برنامه با حالتی از پیش تعریف نشده برخورد می‌کند و چون قابلیت اجرا کردن آنها را ندارد هنگ می‌کند و خروجی منطقی را تحویل نمی‌دهد.

چرا باگ را گزارش دهیم؟

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

در ادامه با مجموعه اصولی که توسعه‌دهندگان توزیع لینوکسی elementary OS برای گزارش‌های باگ‌ها وضع کرده‌اند آشنا می‌شویم.

نکاتی که در هنگم گزارش یک باگ باید در نظر داشت:

۱- یکتا بودن گزارش باگ

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

۲- دقیق بودن عنوان

برای باگ خود عنوان دقیقی انتخاب نمائید. این کار باعث تسهیل کار توسعه‌دهندگان نرم‌افزار در جستجو و مرور لیست باگ‌ها می‌شود. عنوانی مانند «نرم‌افزار X کرش می‌کند» به دلیل ابهام موجود در آن مناسب نیست. عبارتی مانند «عملکرد را بهبود دهید» نیز دردی دوا نخواهد کرد. یک عنوان خوب می‌تواند چیزی شبیه این باشد: «زمانی که فرآیند X به پایان می‌رسد پیامی نمایش داده نمی‌شود».

۳- خودداری از بیان عبارات و ارزش‌های ذهنی، غیرقابل اندازه‌گیری و مبهم

شاید این توصیه شبیه توصیه شماره ۲ باشد، اما اگر تمایل دارید که مشکل یا باگی را گزارش دهید مهم است که بدانید باید حتی‌الامکان کمّی صحبت کنید. اگر نمی‌توانید برای گزارش باگ خود از اعداد و ارقام مقایسه‌ای استفاده کنید، سعی نمائید آنچه با آن مواجه شده و مشاهده کرده‌اید را دقیقا توضیح دهید. برای مثال نگوئید «X خوب کار نمی‌کند» یا «X عملکرد مناسبی ندارد». به جای آن تلاش کنید که توضیح دهید چه اتفاقی رخ داده است و در مقابل شما انتظار چه رخدادی را داشته‌اید. برای مثال: «پنل به جای اینکه به نرمی و با اجرای افکت باز شود، ناگهان ظاهر می‌شود». سخن آخر اینکه مشکل را به گونه‌ای گزارش دهید که ملموس و کاربردی باشد.

۴- گزارش باگ باید جامع و در عین حال مختصر باشد

یکی از مهمترین جنبه‌های یک گزارش باگ یا اشکال این است که توسعه‌دهنده باید بتواند از روی آن گزارش، موقعیت و مشکل مورد نظر را بازسازی نماید. بدین منظور شما باید اطلاعات مرتبط نظیر نسخه سیستم‌عامل (یا نرم‌افزار) خود، نسخه کتابخانه‌های مرتبط نظیر Gtk یا WebKit و هرگونه تغییر و دخل و تصرف در سیستم مثل تغییر در مدیر پنجره یا کرنل را ضمیمه گزارش خود نمائید. اگر می‌خواهید یک کرش (Crash) را گزارش دهید لازم است که backtrace را نیز به گزارش خود اضافه نمائید.

با اینحال باید توجه داشته باشید که بهتر است گزارش شما خلاصه نیز باشد. از طولانی کردن گزارش خود و ارائه اطلاعات بی ارتباط با آن خودداری نمائید.

۵- خود را برای ارائه اطلاعات بیشتر آماده کنید

اگر گزارش شما دارای اطلاعات کافی برای بازتولید اشکال از سوی توسعه‌دهندگان نباشد، معمولا برچسب ناقص (Incomplete)* بر آن می‌خورد. در اغلب موارد یک توسعه‌دهنده از طریق یک نظر درخواست اطلاعات اضافی خاصی را خواهد کرد. اگر چنین اطلاعاتی از سوی شما ارائه نگردد، گزارش شما نهایتا بدون حصول نتیجه منقضی خواهد شد.

اگر شما گزارش باگ خود را به اشتباه در صفحه نرم‌افزار دیگری گزارش دهید، گزارش شما برچسبی مانند (Invalid) خواهد خورد. در چنین مواردی گاهی توسعه‌دهندگان در صورت شناسایی نرم‌افزار مورد نظر شما، خود راسا اقدام به انتقال گزارش مربوطه در صفحه نرم‌افزار مرتبط خواهند کرد در غیر این صورت شما خود باید نرم‌افزار مورد نظر خود را یافته و گزارش باگ خود را ارسال نمائید.

اگر هدف شما از گزارش درخواست یک امکان یا ویژگی جدید باشد توسعه‌دهنده گزارش شما را با برچسب Opinion یا Won’t Fix مشخص خواهد کرد. توسعه‌دهندگان معمولا برای صحبت در مورد چنین مسائلی در دسترس و پاسخگو هستند اما بهتر است آنها را به خاطر برچسب‌هایی که به گزارش شما می‌زنند مورد شماتت قرار ندهید.

۶- گزارش دیگران را تائید نکنید

تمام گزارش باگ‌ها، گزارش باگ نیستند! گاهی کاربر به اشتباه تصور می‌کند که باگی را در نرم‌افزار کشف کرده در حالی که در بسیاری از موارد مشکل ناشی از عدم آشنایی کاربر با نرم‌افزار بوده است و نه وجود باگ در آن. تشخیص اینکه گزارش باگ ناشی از وجود یک باگ واقعیست یا نه بر عهده توسعه‌دهندگان است؛ بنابراین اگر اشکالی که دیگران گزارش کرده‌اند برای شما نیز وجود دارد می‌توانید آن را نشان‌دار کنید. اما در هر حال شما نباید به جای توسعه‌دهندگان گزارش باگ دیگران را مورد تائید قرار دهید. این گزاره در رابطه با گزارش باگ‌های خودتان نیز صحیح است یعنی حتی اگر ۱۰۰٪ نسبت به درستی گزارش خود اطمینان دارید، درست نیست که خودتان گزارش خود را تائید کنید. توسعه‌دهندگان در فرصت مناسب، خود گزارش باگ‌ها را بررسی و در صورت صحت، آنها را تائید خواهند کرد.

۷- از نوشتن نظراتی مثل «من هم همین مشکل را دارم» خودداری کنید

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

* توجه داشته باشید که اصل این راهنمایی برای کاربران لینوکس elementary OS نگارش شده است بنابراین ممکن است این برچسب‌ها در سایر نرم‌افزارها یا پروژه‌ها متفاوت بوده و یا با واژه‌های دیگری نام‌گذاری شده باشند. اما در هر صورت اصول کار یکسان است.

منبع: وبلاگ علی حسین‌زاده

لیبره آفیس 5.1 منتشر شد

نسخه 5.1 لیبره‌آفیس منتشر شد. شما می‌توانید از آدرس زیر این نسخه جدید را دریافت و نصب کنید:

http://fa.libreoffice.org/download/

اگر می‌خواهید از رابط کاربری ترجمه شده به زبان فارسی استفاده کنید، روی «رابط کاربری ترجمه شده» کلیک کنید. علاوه بر نصب کننده اصلی باید فایل‌هائی که از این طریق دریافت می‌کنید نصب کنید تا بتوانید رابط کاربری ترجمه شده به زبان فارسی را ببینید.

نسخه 5 لیبره آفیس منتشر شد!

http://www.libreoffice.org/themes/libreofficenew/img/Jump.png

نسخه 5 لیبره‌آفیس مدتی است که منتشر شده است. شما می‌توانید از آدرس زیر این نسخه جدید را دریافت و نصب کنید:

http://fa.libreoffice.org/download/

اگر می‌خواهید از رابط کاربری ترجمه شده به زبان فارسی استفاده کنید، روی «رابط کاربری ترجمه شده» کلیک کنید. علاوه بر نصب کننده اصلی باید فایل‌هائی که از این طریق دریافت می‌کنید نصب کنید تا بتوانید رابط کاربری ترجمه شده به زبان فارسی را ببینید.

فراخوان ترجمه راهنمای کاربری لیبره آفیس

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

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

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

لینک ثبت نام در ترجمه: (در سایت گروه کاربران لینوکس لاگ کرمانشاه)

http://www.kelug.ir/?page_id=728

لینک کتاب شروع به کار با لیبره آفیس به زبان انگلیسی این‌جاست:

https://wiki.documentfoundation.org/images/0/0f/GS42-GettingStartedLO.odt

و لینک پروژه‌ای که در گیت‌بوک تعریف شده است:

https://www.gitbook.com/book/sahandparsa/getting-stated-lopersian/details

کمک به حل مشکلات لیبره آفیس

Bughuntban50RC

از 29 تا 31 خرداد (19 تا 21 ژوئن)، جلسات آنلاین پیدا کردن و گزارش اشکالات نرم‌افزار به صورت گفتگوی برخط برگزار می‌شود، و اگر می‌خواهید اشکالاتی که پیدا کردید گزارش کنید، می‌توانید در این جلسات گفتگو شرکت کنید. کافی است به آدرس زیر مراجعه کنید: (نیاز به نصب نرم‌افزار irc دارد)

irc://irc.freenode.net/#libreoffice-qa

یا از طریق مرورگرتان این صفحه را باز کنید:

https://webchat.freenode.net/?channels=#libreoffice-qa

لیبره‌آفیس در حال حاضر مشکلات بسیاری دارد، که به خصوص برای فارسی‌زبانان بیش از دیگران است. شما می‌توانید با گزارش این مشکلات به بهبود این نرم‌افزار کدباز و رایگان کمک کنید. اگر زبان انگلیسی نمی‌دانید، کافی است فایلی کوچک که مشکل را نشان می‌دهد جائی آپلود کنید و مشکل را با ارائه لینک فایل همین‌جا در بخش نظرات ذکر کنید.

لیبره‌آفیس 5 در راه است

نسخه 5 لیبره‌آفیس به زودی منتشر خواهد شد. در حال حاضر نسخه آزمایشی (بتا 3) منتشر شده که اگر می‌خواهید به برطرف شدن مشکلات آن کمک کنید، می‌توانید آن را از این‌جا نصب کنید:

http://dev-builds.libreoffice.org/pre-releases/

بر حسب این‌که سیستم عامل شما چیست، می‌توانید نسخه متناسب با خودتان را پیدا کنید.