ما دوست داریم پچ ها و مشارکت های شما را در این پروژه بپذیریم. فقط چند دستورالعمل کوچک وجود دارد که باید از آنها پیروی کنید.
موافقت نامه مجوز مشارکت
مشارکت در هر پروژه Google باید با یک قرارداد مجوز مشارکت کننده همراه باشد. این یک انتساب حق نسخه‌برداری نیست، به سادگی به Google اجازه می‌دهد از مشارکت‌های شما به عنوان بخشی از پروژه استفاده کرده و مجدداً توزیع کند.
اگر فردی هستید که کد منبع اصلی را می نویسید و مطمئن هستید که مالکیت معنوی خود را دارید، باید یک CLA فردی را امضا کنید.
اگر برای شرکتی کار می‌کنید که می‌خواهد به شما اجازه مشارکت در کارتان را بدهد، باید یک CLA شرکتی امضا کنید.
شما معمولاً فقط یک بار باید یک CLA ارسال کنید، بنابراین اگر قبلاً یک CLA را ارسال کرده اید (حتی اگر برای پروژه دیگری بوده باشد)، احتمالاً نیازی به انجام مجدد آن ندارید.
ارسال پچ
به طور کلی بهتر است با باز کردن یک مشکل جدید شروع کنید که در آن باگ یا ویژگیی را که می‌خواهید رفع کنید، توضیح دهید. حتی اگر فکر می کنید نسبتاً جزئی است، دانستن اینکه مردم روی چه چیزی کار می کنند مفید است. در شماره اولیه ذکر کنید که قصد دارید روی آن باگ یا ویژگی کار کنید تا به شما اختصاص داده شود.
روند عادی انشعاب پروژه را دنبال کنید و یک شعبه جدید برای کار در آن راه اندازی کنید. مهم است که هر گروه از تغییرات در شاخه های جداگانه انجام شود تا اطمینان حاصل شود که درخواست کشش فقط شامل تعهدات مربوط به آن اشکال یا ویژگی است.
هر تغییر قابل توجهی تقریباً همیشه باید با آزمایش همراه باشد. این پروژه در حال حاضر پوشش تست خوبی دارد، بنابراین اگر مطمئن نیستید که چگونه آن را انجام دهید، به برخی از آزمایش‌های موجود نگاه کنید.
تمام تلاش خود را بکنید تا برای هر تغییر ، پیام‌های متعهد شکل‌گیری داشته باشید. این یکپارچگی در سراسر پروژه را فراهم می کند و تضمین می کند که پیام های commit می توانند به درستی توسط ابزارهای مختلف git قالب بندی شوند.
در نهایت، commit ها را به چنگال خود فشار دهید و یک درخواست کشش ارسال کنید.