به مخزن کدهای عمومی روبکا خوش آمدید!
این پوشه با هدف ایجاد بستری باز، امن، و آموزشی برای مشارکت توسعهدهندگان از سراسر جهان طراحی شده است. هدف ما فراهم کردن فضایی برای اشتراکگذاری کدهای کوچک، مثالهای آموزشی، و راهحلهای خلاقانه است که میتوانند برای دیگران مفید باشند و به رشد جامعهی روبکا کمک کنند.
- تسهیل یادگیری و تبادل دانش بین توسعهدهندگان با سطوح مختلف تجربه
- ایجاد آرشیوی از کدهای مفید، قابل استفاده مجدد، و قابل توسعه
- تشویق به مشارکت در پروژههای منبعباز و تقویت روحیه همکاری
- فراهمسازی بستری برای تمرین، آموزش، و نمایش تواناییهای فردی
برای افزودن کد خود به این پوشه، لطفاً مراحل زیر را دنبال کنید:
- مخزن روبکا را Fork کنید.
- کد خود را در پوشهی
community_snippets/قرار دهید. - در صورت نیاز، یک فایل توضیحی (
README.md) برای کد خود اضافه کنید. - یک Pull Request ارسال کنید.
- تیم نگهداری پروژه کد شما را بررسی کرده و در صورت تأیید، آن را Merge خواهد کرد.
در صورت نیاز به راهنمایی بیشتر، میتوانید از طریق بخش Issues با ما در ارتباط باشید.
برای حفظ نظم، خوانایی، و قابلیت استفاده مجدد، لطفاً موارد زیر را رعایت کنید:
- هر کد در یک فایل مستقل قرار گیرد.
- نام فایل باید گویا، مرتبط با عملکرد کد، و ترجیحاً به زبان انگلیسی باشد.
مثال:async_fetch_example.py - در صورت نیاز به توضیحات بیشتر، از کامنتهای داخل کد یا فایل README همراه استفاده کنید.
- اگر کد شما وابسته به کتابخانه خاصی است، آن را در توضیحات ذکر کنید.
- در صورت امکان، کد را به گونهای بنویسید که قابل اجرا و تست باشد.
ساختار پیشنهادی پوشه:
community_snippets/ ├── async/ │ └── asyncfetchexample.py ├── text/ │ └── kurdishtextcleaner.py ├── utils/ │ └── json_prettifier.py └── README.md
برای حفظ کیفیت، امنیت، و احترام به حقوق دیگران، رعایت موارد زیر الزامی است:
- فقط از کدهایی استفاده کنید که مالک آن هستید یا مجوز انتشار آن را دارید.
- از انتشار کدهای مخرب، حاوی بدافزار، یا دارای محتوای نامناسب خودداری کنید.
- از زبان محترمانه و حرفهای در کامنتها، توضیحات، و ارتباطات استفاده کنید.
- در صورت استفاده از کد دیگران، حتماً منبع آن را ذکر کنید.
- از انتشار اطلاعات شخصی، حساس، یا محرمانه در کدها خودداری نمایید.
- از انتشار کدهای بسیار طولانی یا پروژههای کامل در این پوشه خودداری کنید. این بخش مخصوص قطعهکدهای کوچک و آموزشی است.
تمام کدهای موجود در این پوشه تحت مجوز اصلی پروژه روبکا منتشر میشوند (مثلاً MIT License).
با ارسال Pull Request، شما موافقت میکنید که کدتان تحت همان مجوز منتشر شود و دیگران بتوانند از آن استفاده کنند.
در صورت استفاده از کتابخانههای خارجی یا کدهای دارای مجوز خاص، لطفاً مجوز مربوطه را در فایل README یا کامنتها ذکر نمایید.
در صورت وجود هرگونه سوال، پیشنهاد، یا گزارش مشکل، لطفاً از طریق یکی از روشهای زیر با ما در ارتباط باشید:
- ارسال Issue در مخزن GitHub
- ارسال پیام در Pull Request
- ارتباط از طریق کانال رسمی روبکا (در صورت وجود)
ما مشتاق شنیدن نظرات، پیشنهادات، و بازخوردهای شما هستیم.
اگرچه زبان اصلی پروژه انگلیسی است، مشارکت به زبانهای دیگر نیز پذیرفته میشود.
هدف ما ایجاد جامعهای چندزبانه، فراگیر، و جهانی است که در آن توسعهدهندگان بتوانند با زبان مادری خود نیز مشارکت کنند.
- لطفاً نام فایلها و پوشهها را به زبان انگلیسی انتخاب کنید.
- میتوانید توضیحات و کامنتها را به زبان فارسی، کردی، انگلیسی یا هر زبان دیگری بنویسید.
- اگر کد شما آموزشی است، ترجمهی چندزبانهی توضیحات میتواند بسیار مفید باشد.
نام تمام مشارکتکنندگان پذیرفتهشده در فایل CONTRIBUTORS.md ثبت خواهد شد.
این فایل شامل نام، لینک پروفایل GitHub، و عنوان کد ارسالی شما خواهد بود.
با این کار، هم از شما تقدیر میشود و هم دیگران میتوانند از تجربیات شما استفاده کنند.
- ساختن رزومهی حرفهای در GitHub
- یادگیری از بازخوردهای واقعی
- کمک به رشد جامعهی روبکا
- اشتراکگذاری دانش و تجربه
- تمرین مستندسازی و توسعهی منبعباز
- ایجاد ارتباط با توسعهدهندگان دیگر
با مشارکت شما، این پروژه رشد میکند و به منبعی ارزشمند برای یادگیری، آموزش، و توسعه تبدیل میشود.
از اینکه وقت گذاشتید و دانش خود را با دیگران به اشتراک میگذارید، صمیمانه سپاسگزاریم.
با احترام،
تیم توسعهدهنده روبکا