ประมวลผลคําขอดึงข้อมูล
หลังจากที่คุณเปิดคําขอดึงข้อมูล (PR) แล้ว PR จะผ่านการตรวจสอบและการตรวจสอบเพื่อให้แน่ใจว่าสามารถรวมการเปลี่ยนแปลงที่เสนอได้ สําหรับข้อมูลพื้นฐานเพิ่มเติมเกี่ยวกับ PR โปรดดู ข้อมูลพื้นฐานของ Git และ GitHub
การตรวจสอบความถูกต้อง
ก่อนที่ PR ของคุณสามารถรวมเข้ากับสาขาปลายทาง อาจจําเป็นต้องผ่านกระบวนการตรวจสอบ PR หนึ่งรายการหรือมากกว่านั้น หลังจากที่คุณเลือก สร้างคําขอดึงข้อมูล GitHub จะเรียกใช้การตรวจสอบความถูกต้องที่กําหนดค่าไว้สําหรับที่เก็บของคุณ เมื่อกระบวนการตรวจสอบความถูกต้องเสร็จสิ้น ผลลัพธ์จะปรากฏใน PR
กระบวนการตรวจสอบความถูกต้องจะแตกต่างกันไปขึ้นอยู่กับขอบเขตของการเปลี่ยนแปลงที่เสนอและกฎของที่เก็บปลายทาง หลังจากที่คุณส่ง PR ของคุณ แล้ว คุณสามารถคาดหวังว่าสิ่งใดสิ่งหนึ่งต่อไปนี้จะเกิดขึ้น:
- ความสามารถในการรวมกัน: การทดสอบการรวมกลุ่ม GitHub พื้นฐานจะเกิดขึ้นก่อนเพื่อตรวจสอบว่าการเปลี่ยนแปลงที่เสนอในสาขาของคุณขัดแย้งกับสาขาปลายทางหรือไม่ หาก PR ระบุว่าการทดสอบนี้ล้มเหลว คุณต้องปรับเนื้อหาที่ทําให้เกิดความขัดแย้งในการรวมก่อนดําเนินการต่อ
- ข้อตกลงการอนุญาตใช้สิทธิการร่วมสร้าง (CLA): ในฐานะผู้สนับสนุนที่ไม่ใช่ของ Microsoft หากคุณกําลังร่วมให้ข้อมูลในที่เก็บสาธารณะ คุณอาจถูกขอให้กรอก CLA สั้นๆ ในครั้งแรกที่คุณส่ง PR ไปยังที่เก็บนั้น หลังจากล้างขั้นตอน CLA แล้ว PR ของคุณจะได้รับการประมวลผล
- การติดป้ายกํากับ: ป้ายกํากับจะใช้กับ PR ของคุณโดยอัตโนมัติเพื่อระบุสถานะของ PR ของคุณเมื่อผ่านเวิร์กโฟลว์การตรวจสอบความถูกต้อง ตัวอย่างเช่น PR ใหม่อาจได้รับป้ายกํากับ "อย่ารวม(do-not-merge)" โดยอัตโนมัติ ซึ่งแสดงว่า PR ยังไม่ได้เสร็จสิ้นขั้นตอนการตรวจสอบความถูกต้อง การตรวจทาน และการลงชื่อออก
- การตรวจสอบความถูกต้องและสร้าง: การตรวจสอบโดยอัตโนมัติตรวจสอบว่าการเปลี่ยนแปลงของคุณผ่านการตรวจสอบความถูกต้องหรือไม่ การทดสอบการตรวจสอบความถูกต้องอาจทําให้เกิดคําเตือนหรือข้อผิดพลาดที่ทําให้คุณแก้ไขไฟล์อย่างน้อยหนึ่งไฟล์ใน PR ของคุณก่อนจึงจะสามารถผสานได้ ผลการตรวจสอบจะถูกเพิ่มเป็นข้อคิดเห็นในคําขอดึงข้อมูลของคุณเพื่อการตรวจสอบของคุณ และความคิดเห็นนั้นอาจส่งถึงคุณทางอีเมล
- การแสดงข้อมูล: เมื่อตรวจสอบความถูกต้องและสร้างสําเร็จ บทความที่คุณเปลี่ยนจะถูกปรับใช้ไปยังสภาพแวดล้อมการจัดเตรียมโดยอัตโนมัติเพื่อตรวจสอบ URL ที่แสดงตัวอย่างจะปรากฏในข้อความคิดเห็น PR
- การผสานอัตโนมัติ: PR อาจทําการผสานโดยอัตโนมัติหากผ่านการตรวจสอบความถูกต้องและเกณฑ์ที่กําหนด ในกรณีนี้ คุณไม่จําเป็นต้องทําอะไรอีก
ตรวจทานและแก้ไขข้อคิดเห็น
หลังจากการประมวลผล PR ทั้งหมดเสร็จสมบูรณ์ คุณควรตรวจสอบผลลัพธ์ (ตัวอย่างเช่น ข้อคิดเห็นของ PR ผลลัพธ์การสร้าง) พิจารณาว่าคุณจําเป็นต้องทําการเปลี่ยนแปลงเพิ่มเติมหรือไม่ก่อนที่จะลงชื่อออกสําหรับการผสาน คุณอาจจําเป็นต้องเปลี่ยนเนื้อหาของคุณเนื่องจากเหตุผลต่อไปนี้:
- ข้อคิดเห็น PR จากผู้ตรวจสอบ หากผู้ตรวจสอบ PR ได้ตรวจสอบ PR ของคุณแล้ว พวกเขาสามารถให้คําติชมผ่านข้อคิดเห็นหากมีปัญหาหรือคําถามที่จะต้องแก้ไขก่อนผสาน
- คําติชมจากผู้ตรวจสอบเพียร์
- การแก้ไขการจัดรูปแบบเนื่องจากปัญหาการแสดงผล
- ข้อผิดพลาดหรือคําเตือนการตรวจสอบความถูกต้อง
- ข้อขัดแย้งการผสาน
หากคุณจําเป็นต้องเปลี่ยนแปลง คุณสามารถแก้ไขเนื้อหาของคุณได้โดยตรงใน PR หรือคุณสามารถกลับไปยังรหัส VS เพื่อทําการเปลี่ยนแปลงของคุณได้ เมื่อคุณทําเสร็จแล้ว ให้ยอมรับการเปลี่ยนแปลงของคุณในสาขาการทํางานของคุณ PR จะได้รับการอัปเดตโดยอัตโนมัติด้วยการเปลี่ยนแปลงของคุณ
แต่ละครั้งที่คุณเพิ่มการยอมรับไปยังสาขาการทํางานเดียวกัน การยอมรับจะถูกเพิ่มโดยอัตโนมัติไปยัง PR ด้วยแต่ละบันทึก ระบบการเผยแพร่จะเรียกใช้การตรวจสอบความถูกต้องและตรวจสอบกระบวนการโดยอัตโนมัติ
ระบบอัตโนมัติในการลงชื่อออกและข้อคิดเห็น
เมื่อคุณจัดการกับข้อผิดพลาดในคําติชมและการตรวจสอบความถูกต้องทั้งหมดแล้ว และคุณพร้อมที่จะรวมการเปลี่ยนแปลงของคุณแล้ว ถึงเวลาลงชื่อออกจาก PR ของคุณด้วยการสร้างข้อคิดเห็นใหม่ที่อ่าน#sign-off
คุณต้องป้อน #sign-off
ข้อคิดเห็นเพื่อผสานการเปลี่ยนแปลงของคุณ แม้ว่าการตรวจสอบและการตรวจสอบความถูกต้องทั้งหมดจะผ่าน คุณรับผิดชอบในการใช้ข้อคิดเห็นนี้เพื่อแจ้งให้ผู้ตรวจสอบ PR และผู้ดูแลระบบที่เก็บทราบว่าการเปลี่ยนแปลงของคุณพร้อมสําหรับการผสานแล้ว
เมื่อผู้ตรวจสอบตัดสินใจว่า PR ของคุณไม่มีปัญหาและได้ลงชื่อออก การเปลี่ยนแปลงของคุณจะถูกรวมเข้ากับสาขาเริ่มต้นและ PR จะถูกปิด
ข้อความคิดเห็นอัตโนมัติช่วยให้ผู้ใช้ที่ไม่มีสิทธิ์เขียนใน repo สามารถเขียนได้โดยการกําหนดป้ายกํากับที่เหมาะสมให้กับ PR หากคุณกําลังทํางานใน repo ที่มีการใช้งานระบบข้อความคิดเห็นอัตโนมัติ ให้ใช้ความคิดเห็นแบบแฮชแท็กที่แสดงในตารางต่อไปนี้เพื่อกําหนดป้ายกํากับ เปลี่ยนป้ายกํากับ หรือปิด PR ผู้เขียน Microsoft จะได้รับการแจ้งเตือนทางอีเมลเพื่อตรวจทานและลงชื่อออกเมื่อใดก็ตามที่มีการเสนอการเปลี่ยนแปลงในบทความของตน
ข้อคิดเห็นแบบแฮชแท็ก | สิ่งที่ทำ |
---|---|
#sign-off |
กําหนด ป้ายพร้อม-ให้รวม โดยอัตโนมัติเพื่อให้ผู้ตรวจทานใน repo ทราบว่า PR พร้อมสําหรับการตรวจทาน/ผสานแล้ว หากคุณ ไม่ใช่ ผู้เขียนที่อยู่ในรายการและพยายามลงชื่อออกจาก PR ของ repo สาธารณะโดยใช้ #sign-off ความคิดเห็น PR จะได้รับการอัปเดตเพื่อระบุว่าเฉพาะผู้เขียนเท่านั้นที่สามารถกําหนดป้ายกํากับได้ |
#hold-off |
ลบป้ายพร้อม-ให้-รวม ในกรณีที่คุณเปลี่ยนใจหรือทําผิดพลาด ใน repo ส่วนตัว สิ่งนี้จะกำหนดป้ายกำกับอย่า-รวม |
#please-close |
ปิด PR หากคุณตัดสินใจที่จะไม่รวมการเปลี่ยนแปลง |
#please-open |
เปิด PR หรือประเด็นที่ปิดแล้วอีกครั้ง |
กำลังเผยแพร่
PR ของคุณจะต้องผสานรวมโดยผู้ตรวจสอบ PR ก่อนจึงจะสามารถรวมการเปลี่ยนแปลงในการเผยแพร่ตามกําหนดเวลาถัดไปได้ โดยปกติ PR จะได้รับการตรวจสอบและผสานรวมกันตามลําดับการส่ง
หลังจากการร่วมสร้างข้อมูลของคุณได้รับการอนุมัติและผสาน กระบวนการเผยแพร่จะเลือกเอกสารเหล่านั้น เวลาการตีพิมพ์อาจแตกต่างกันไป ขึ้นอยู่กับทีมที่จัดการที่เก็บที่คุณกําลังร่วมสร้างเวลาการตีพิมพ์ แต่มักจะเกิดขึ้นอย่างน้อยหนึ่งครั้งในทุกวันทํางาน อาจใช้เวลาถึง 45 นาทีก่อนบทความจะปรากฏทางออนไลน์หลังจากตีพิมพ์
เมื่อการเปลี่ยนแปลงของคุณได้รับการเผยแพร่ แล้ว พวกเขาจะถ่ายทอดสดบน Microsoft Learn เพื่อให้บุคคลอื่นสามารถเริ่มเรียนรู้ได้!
ขั้นตอนถัดไป
เพียงเท่านี้ก็เรียบร้อย! คุณได้ทําการจัดสรรเนื้อหา Microsoft Learn แล้ว!