کنار آمدن با مشکلات¶
پایتون زبان برنامه نویسی بالغیست که پایداریش شهرتی به هم زده. توسعهدهندگانش مایلند برای حفظ این شهرت از هر نقصی که در پایتون مییابید آگاه شوند.
گاهی حل مشکل به دست خودتان و فرستادن وصله به پایتون سریعتر است؛ زیرا فرایند را یکسره کرده و افراد کمتری را درگیر میکند. آموختن چگونگی مشارکت در contribute.
مشکلات مستندات¶
اگر مشکلی در این مستندات یافته یا میخواهید بهبودی را پیشنهاد دهید، گزارش مشکلی روی issue tracker. ثبت کنید. اگر برای حلش پیشنهادی دارید، آن را هم بنویسید.
If the bug or suggested improvement concerns the translation of this documentation, submit the report to the translation’s repository instead.
همچنین میتوانید گفتوگویی در انجمنهای گفتمان مستندات بگشایید.
اگر شما یک باگ در نحوه نمایش تم ها (اچ تی ام ال - سی اس اس - جاوا اسکریپت) در مستندات پیدا کردید, لطفا یک گزارش باگ بر روی آدرس ثبت کنید.
همچنین ملاحظه نمائید
- اشکالات مستندات
فهرستی از باگهای مستندات که به پایگاه پیگیری مشکلات پایتون ارسال شدهاند.
- پیگیری مشکل
مروری بر فرایند ثبت پیشنهاد بهبود در پایگاه پیگیری مشکلات.
- کمک به مستندسازی
راهنمای جامع برای افرادی که علاقهمند به مشارکت در مستندات Python هستند.
- ترجمه های مستندات
فهرستی از صفحات GitHub مربوط به ترجمهٔ مستندات و راههای ارتباطی مسئولان هر یک.
استفاده از پایگاه پیگیری مشکلات پایتون¶
گزارشهای خطا برای پایتون باید از طریق پایگاه پیگیری مشکلات گیتهاب (https://github.com/python/cpython/issues) ارسال شوند. پایگاه پیگیری مشکلات گیتهاب یک فرم وب ارائه میدهد که امکان وارد کردن اطلاعات مرتبط و ارسال آن به توسعهدهندگان را فراهم میکند.
اولین گام در ارائه یک گزارش این است که مشخص کنید آیا مشکل قبلاً گزارش شده است یا خیر. مزیت انجام این کار، علاوه بر صرفه جویی در وقت توسعه دهندگان، این است که میتوانید بفهمید چه اقداماتی برای رفع آن انجام شده است؛ ممکن است مشکل برای نسخه بعدی قبلاً رفع شده باشد، یا اطلاعات بیشتری مورد نیاز باشد (در این صورت، اگر میتوانید، خوشحال میشویم آن را ارائه دهید!). برای انجام این کار، در نوار جستجو بالای صفحه "tracker" را جستجو کنید.
اگر مشکلی که گزارش میدهید در لیست موجود نباشد، وارد GitHub شوید. اگر قبلاً حساب GitHub ندارید، با استفاده از لینک "Sign up" یک حساب جدید ایجاد کنید. ارسال گزارش باگ به صورت ناشناس امکان پذیر نیست.
اکنون که وارد سیستم شده اید، می توانید یک مشکل ثبت کنید. برای گزارش یک مشکل جدید، روی دکمه "New issue" در نوار بالا کلیک کنید.
فرم ارسال شامل دو فیلد است، "Title" و "Comment".
برای بخش "Title", یک توضیح کوتاه از مشکل وارد کنید؛ کمتر از ده کلمه مناسب است.
در قسمت "Comment", مشکل را با جزئیات بیان کنید، از جمله اینکه انتظار داشتید چه اتفاقی بیفتد و چه چیزی واقعاً اتفاق افتاد. حتماً اشاره کنید که آیا ماژولهای افزونهای درگیر بودند یا خیر و از چه سخت افزار و پلتفرم نرمافزاری استفاده میکردید (شامل اطلاعات نسخه در صورت لزوم).
هر گزارش خطا توسط یک توسعهدهنده بررسی خواهد شد که تصمیم میگیرد چه اقداماتی برای رفع مشکل نیاز است. هر بار که اقدامی روی گزارش انجام شود، به شما اطلاعرسانی خواهد شد.
همچنین ملاحظه نمائید
- نحوه گزارش اشکالات به طور موثر
مقالهای که بهطور مفصل به چگونگی ایجاد یک گزارش باگ مفید میپردازد. این مقاله بیان میکند که چه نوع اطلاعاتی مفید هستند و چرا این اطلاعات مفید میباشند.
- راهنمای نوشتن گزارش خطا
اطلاعاتی دربارهٔ نحوهٔ نگارش یک گزارش خطای خوب. بخشی از این اطلاعات به پروژهٔ موزیلا اختصاص دارد، اما اصول کلی و خوبِ گزارشدهی را نیز توضیح میدهد.
شروع مشارکت شخصی در توسعهٔ پایتون¶
علاوه بر گزارش اشکالاتی که پیدا میکنید، می توانید وصلههایی برای رفع آن ها ارسال کنید. میتوانید اطلاعات بیشتری درباره ی نحوه ی شروع به وصله زدن Python را در "Python Developer's Guide" پیدا کنید. اگر سوالی دارید، "core-mentorship mailing list" جای دوستانهای برای دریافت پاسخ به هر سوال مربوط به فرآیند رفع اشکالات در Python است.