پرش به محتویات

راهنمای مشارکت

راه‌های زیادی برای مشارکت در BeeWare وجود دارد. این راهنماها هر آنچه را که برای ارائه مشارکت خود نیاز دارید، پوشش می‌دهند.

چه کار می‌توانم بکنم؟

رفع یک مشکل

مهم‌ترین کمکی که می‌توانید انجام دهید این است که کد بنویسید تا یک مشکل شناخته‌شده را رفع کنید.

پیاده‌سازی یک ویژگی جدید

آیا BeeWare فاقد ویژگی‌ای است که دوست دارید ببینید؟ شما می‌توانید یک ویژگی جدید پیاده‌سازی کنید.

مستندسازی بنویسید

هیچ ویژگی‌ای کامل نیست مگر اینکه به‌خوبی مستندسازی شود. نوشتن مستندات راهی برای مشارکت است که نیازی به نوشتن کد ندارد.

اولویت‌بندی یک مسئله

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

بررسی یک درخواست کشش

وقتی یک درخواست کشش ارسال می‌شود، قبل از ادغام باید بررسی شود. صرف‌نظر از اینکه تا چه حد با محتوا آشنا باشید، احتمالاً راهی وجود دارد که بتوانید در بررسی درخواست کشش کمک کنید.

پیشنهاد یک ویژگی جدید

آیا پیشنهادی یا ایده‌ای برای افزودن قابلیت جدید به یکی از ابزارهای BeeWare دارید؟ می‌توانید یک ویژگی جدید را برای بررسی پیشنهاد دهید.

محتوا را ترجمه کنید

BeeWare مستندات مختلفی را به زبان‌های گوناگون نگهداری می‌کند. اگر به زبانی غیر از انگلیسی مسلط هستید، می‌توانید در ترجمه‌ی محتوا کمک کنید.

ابزارها را استفاده کنید

آیا ایده‌ای برای ساخت یک اپلیکیشن با Toga دارید؟ آیا اپلیکیشنی موجود دارید که بتوان آن را با Briefcase بسته‌بندی کرد؟ می‌توانید از ابزارها استفاده کنید و بازخورد خود را درباره تجربه‌تان ارائه دهید.

چگونه مشارکت کنم؟

راه‌اندازی محیط توسعه

قبل از اینکه بتوانید به BeeWare کمک کنید، باید محیط توسعه خود را راه‌اندازی کنید.

تولید مجدد یک مشکل

قبل از رفع یک مشکل، باید تأیید کنید که وجود دارد. بازتولید یک مشکل نیز بخش مهمی از تریاژ است.

کار از یک شعبه

هنگام آماده‌سازی برای ارسال یک مشارکت، همیشه از یک شاخه کار کنید.

اجتناب از گسترش دامنه

مهم است که تمرکز خود را حفظ کنید و از گسترش بی‌رویه دامنه کار خود اجتناب کنید.

پیشنهاد یک ویژگی جدید

شما این مراحل را برای پیشنهاد یک ویژگی جدید دنبال خواهید کرد.

کد بنویسید، اجرا کنید و تست کنید

برای به‌روزرسانی یا مشارکت در کد، باید کد خود را بنویسید، اجرا کنید و آزمایش کنید.

مستندسازی ساخت

برای به‌روزرسانی یا مشارکت در مستندات، باید قادر به ساخت مستندات باشید.

مستندسازی بنویسید

برای مشارکت در مستندسازی، شما محتوای جدید می‌نویسید یا محتوای موجود را به‌روزرسانی می‌کنید.

افزودن یادداشت تغییر

هر درخواست تغییر باید همراه با یک یادداشت تغییرات باشد.

ارسال درخواست ادغام

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

ارائه بازخورد

اگر راحت هستید، می‌توانید نقدی بر مشارکت شخص دیگری ارائه دهید.

محتوا را ترجمه کنید

BeeWare از Weblate برای ترجمه‌ها استفاده می‌کند که برای شروع به چند مرحله نیاز دارد.

ارسال یک مشکل جدید

اگر با یک مشکل یا باگ جدید مواجه شدید، مفید است که یک مسئله ثبت کنید.

بعد چه می‌شود؟

بازبینی درخواست کشش

وقتی یک درخواست کشش ارسال می‌شود، گام بعدی بازبینی PR است.

فرآیند انتشار

مشارکت‌های ادغام‌شده از فرآیند انتشار عبور خواهند کرد.

راهنماهای سبک

راهنمای سبک کد

این‌ها دستورالعمل‌های مشارکت در پروژه‌های BeeWare هستند.

راهنمای سبک مستندسازی

این‌ها دستورالعمل‌هایی برای مشارکت در مستندسازی پروژه‌های BeeWare هستند.