วิธีการมีส่วนร่วม

เรายินดีรับแพตช์และการสนับสนุนของคุณในโปรเจ็กต์นี้ มีหลักเกณฑ์เล็กๆ น้อยๆ ไม่กี่อย่างที่คุณต้องปฏิบัติตาม

ข้อตกลงใบอนุญาตผู้สนับสนุน

การมีส่วนร่วมในโปรเจ็กต์ Google จะต้องมาพร้อมกับข้อตกลงใบอนุญาตผู้สนับสนุน นี่ไม่ใช่การมอบหมายด้านลิขสิทธิ์ แต่เป็นการให้สิทธิ์ Google ในการใช้และแจกจ่ายการมีส่วนร่วมของคุณซ้ำซึ่งเป็นส่วนหนึ่งของโปรเจ็กต์

  • หากคุณเป็นบุคคลธรรมดาที่เขียนซอร์สโค้ดต้นฉบับและมั่นใจว่าคุณเป็นเจ้าของทรัพย์สินทางปัญญา คุณจะต้องลงนามใน CLA ส่วนบุคคล

  • หากทำงานในบริษัทที่ต้องการอนุญาตให้คุณมีส่วนร่วมในงาน คุณจะต้องลงนามใน CLA ของบริษัท

โดยทั่วไปแล้ว คุณเพียงต้องส่ง CLA เพียงครั้งเดียว ดังนั้นหากส่ง CLA แล้ว (แม้ว่าจะเป็นโครงการอื่น) คุณอาจไม่จำเป็นต้องส่ง CLA อีก

กำลังส่งแพตช์

  1. โดยทั่วไปแล้ว การเริ่มด้วยการเปิดปัญหาใหม่ที่อธิบายข้อบกพร่องหรือฟีเจอร์ที่คุณต้องการแก้ไข แม้คุณจะคิดว่านี่เป็นเรื่องเล็กน้อย แต่การรู้ว่าผู้คนกำลังทำอะไรกันอยู่ก็มีประโยชน์ แจ้งในเบื้องต้นว่าคุณกำลังวางแผนทำงานกับข้อบกพร่องหรือฟีเจอร์ดังกล่าวเพื่อให้สามารถกำหนดข้อบกพร่องหรือฟีเจอร์ให้คุณได้

  2. ทำตามขั้นตอนปกติในการแยกโปรเจ็กต์ และตั้งค่าสาขาใหม่ให้ทำงาน การเปลี่ยนแปลงแต่ละกลุ่มควรทำแยกเป็น Branch เพื่อให้มั่นใจว่าคำขอพุลจะรวมเฉพาะคอมมิตที่เกี่ยวข้องกับข้อบกพร่องหรือฟีเจอร์ดังกล่าว

  3. การเปลี่ยนแปลงที่สำคัญใดๆ ควรมาพร้อมกับการทดสอบเกือบทุกครั้ง โปรเจ็กต์มีการครอบคลุมการทดสอบที่ดีอยู่แล้ว ดังนั้นให้ลองดูการทดสอบที่มีอยู่หากไม่แน่ใจว่าต้องทำอย่างไร

  4. โปรดพยายามทำให้ข้อความคอมมิตมีรูปแบบเหมาะสมสำหรับการเปลี่ยนแปลงแต่ละครั้ง การดำเนินการนี้ทำให้เกิดความสอดคล้องกันตลอดทั้งโปรเจ็กต์และตรวจสอบว่าข้อความคอมมิตสามารถจัดรูปแบบอย่างเหมาะสมโดยใช้เครื่องมือ Git ต่างๆ

  5. สุดท้าย ให้พุชคอมมิตกับส้อมของคุณและส่งคำขอแบบพุล