نحوه مشارکت
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
ما دوست داریم پچ ها و مشارکت های شما را در این پروژه بپذیریم. فقط چند دستورالعمل کوچک وجود دارد که باید از آنها پیروی کنید.
موافقت نامه مجوز مشارکت
مشارکت در هر پروژه Google باید با یک قرارداد مجوز مشارکت کننده همراه باشد. این یک انتساب حق نسخه‌برداری نیست، به سادگی به Google اجازه می‌دهد از مشارکت‌های شما به عنوان بخشی از پروژه استفاده کرده و مجدداً توزیع کند.
اگر فردی هستید که کد منبع اصلی را می نویسید و مطمئن هستید که مالکیت معنوی خود را دارید، باید یک CLA فردی را امضا کنید.
اگر برای شرکتی کار می‌کنید که می‌خواهد به شما اجازه مشارکت در کارتان را بدهد، باید یک CLA شرکتی امضا کنید.
شما معمولاً فقط یک بار باید یک CLA ارسال کنید، بنابراین اگر قبلاً یک CLA را ارسال کرده اید (حتی اگر برای پروژه دیگری بوده باشد)، احتمالاً نیازی به انجام مجدد آن ندارید.
ارسال پچ
به طور کلی بهتر است با باز کردن یک مشکل جدید شروع کنید که در آن باگ یا ویژگیی را که می‌خواهید رفع کنید، توضیح دهید. حتی اگر فکر می کنید نسبتاً جزئی است، دانستن اینکه مردم روی چه چیزی کار می کنند مفید است. در شماره اولیه ذکر کنید که قصد دارید روی آن باگ یا ویژگی کار کنید تا به شما اختصاص داده شود.
روند عادی انشعاب پروژه را دنبال کنید و یک شعبه جدید برای کار در آن راه اندازی کنید. مهم است که هر گروه از تغییرات در شاخه های جداگانه انجام شود تا اطمینان حاصل شود که درخواست کشش فقط شامل تعهدات مربوط به آن اشکال یا ویژگی است.
هر تغییر قابل توجهی تقریباً همیشه باید با آزمایش همراه باشد. این پروژه در حال حاضر پوشش تست خوبی دارد، بنابراین اگر مطمئن نیستید که چگونه آن را انجام دهید، به برخی از آزمایش‌های موجود نگاه کنید.
تمام تلاش خود را بکنید تا برای هر تغییر ، پیام‌های متعهد شکل‌گیری داشته باشید. این یکپارچگی در سراسر پروژه را فراهم می کند و تضمین می کند که پیام های commit می توانند به درستی توسط ابزارهای مختلف git قالب بندی شوند.
در نهایت، commit ها را به چنگال خود فشار دهید و یک درخواست کشش ارسال کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["Contribute to the project by following the guidelines and signing a Contributor License Agreement (CLA) if you haven't already."],["Before submitting code changes, open an issue to discuss the bug or feature and create a new branch for your work."],["Ensure your contributions include tests, well-formatted commit messages, and are submitted as a pull request."]]],["Contributors must sign a Contributor License Agreement (CLA), either individual or corporate, granting Google usage rights. To submit a patch, first open an issue describing the bug/feature and claim it. Then, fork the project, work in a new branch, and include tests for significant changes. Use well-formed commit messages. Finally, push commits to the fork and submit a pull request. Separate branches for distinct groups of changes are crucial.\n"]]
