ตัวชี้วัดพูลรีเควสต์และการทบทวนโค้ด
การทบทวนคือจุดที่งานที่ทำเสร็จแล้วต้องรอบ่อยที่สุด จึงควรวัดว่าการเปลี่ยนแปลงค้างอยู่นานเท่าใดก่อนที่ใครจะมาดู ใหญ่เพียงใด และถูกส่งกลับบ่อยเพียงใด และจับคู่ตัวเลขด้านความเร็วทุกตัวกับสัญญาณด้านคุณภาพ เพื่อไม่ให้เร็วขึ้นกลายเป็นการทำอย่างลวก ๆ
ภาพรวมและแรงจูงใจ
พูลรีเควสต์ (pull request) คือข้อเสนอให้รวมชุดการเปลี่ยนแปลงจากกิ่งหนึ่งของคลังระบบควบคุมเวอร์ชันเข้าไปในอีกกิ่งหนึ่ง พร้อมกับบทสนทนาว่าควรรวมหรือไม่ ในหลายทีมมันคือด่านทางการระหว่าง “ผู้เขียนคิดว่าใช้ได้” กับ “ทีมเห็นพ้องว่าปล่อยได้” บทสนทนานั้นเป็นรูปแบบหนึ่งของการทบทวนโค้ด คือบุคคลอื่นที่ไม่ใช่ผู้เขียนอ่านการเปลี่ยนแปลง ถามคำถาม และอนุมัติหรือขอให้แก้ไข บางแพลตฟอร์มเรียกสิ่งเดียวกันว่าเมิร์จรีเควสต์ (merge request) หัวข้อนี้ใช้ “พูลรีเควสต์” สำหรับทั้งสอง
การทบทวนควรวัดด้วยเหตุผลธรรมดา ในมุมมองการไหลของงานของการส่งมอบ รายการงานใช้เวลาส่วนใหญ่ของชีวิตไปกับการรอ และการทบทวนเป็นหนึ่งในการรอที่อยู่ในการควบคุมของทีมทั้งหมด คอขวดของแพลตฟอร์มร่วมหรือความเกี่ยวเนื่องภายนอกต้องให้ผู้อื่นเปลี่ยน พูลรีเควสต์ที่รอสองวันกว่าจะมีคนดูครั้งแรกต้องการเพียงให้นิสัยของทีมเองเปลี่ยน การวัดการไหลของงานในหนังสือเล่มนี้ (ดูหัวข้อ 2.1 “การวัดการไหลของงาน” และหัวข้อ 2.2 “ลีดไทม์ รอบเวลา และประสิทธิภาพการไหล”) ให้คำศัพท์ทั่วไป หัวข้อนี้ซูมเข้าไปที่หนึ่งขั้นของวงจรและให้เครื่องมือวัดของตนเอง
มุมมองแบบคล่องตัวและ ITIL มาพบกันตรงนี้อย่างมีประโยชน์ จากมุมมองแบบคล่องตัว การทบทวนเป็นวงจรข้อเสนอแนะและกลไกการสอน ช่วยกระจายความรู้เรื่องโค้ดเบส จับข้อบกพร่องแต่เนิ่น ๆ และบังคับใช้ข้อตกลงการทำงานและนิยามของเสร็จของทีม จากมุมมอง ITIL กิจกรรมเดียวกันสนับสนุนหลายแนวปฏิบัติ ใน ITIL 4 แนวปฏิบัติการพัฒนาและการจัดการซอฟต์แวร์ครอบคลุมวิธีสร้างและตรวจสอบซอฟต์แวร์ การเปิดทางให้เกิดการเปลี่ยนแปลงครอบคลุมวิธีประเมินและอนุมัติการเปลี่ยนแปลง และการจัดการการติดตั้งใช้งานครอบคลุมวิธีที่การเปลี่ยนแปลงไปถึงสภาพแวดล้อมจริง พูลรีเควสต์ที่ผ่านการทบทวนโดยเพื่อนร่วมงานเป็นหลักฐานในหลายองค์กรว่าการเปลี่ยนแปลงมาตรฐานได้รับการประเมินก่อนปล่อย การถือการทบทวนเป็นกิจกรรมที่วัดและปรับปรุงได้รับใช้ทั้งสองมุมมอง ทีมแบบคล่องตัวต้องการข้อเสนอแนะที่เร็วขึ้น และแนวปฏิบัติของ ITIL ต้องการหลักประกันที่เชื่อถือได้ว่าการเปลี่ยนแปลงได้รับการตรวจสอบ
ความเสี่ยงที่ต้องคงไว้ในสายตาตลอดคือความเร็วของการทบทวนและคุณภาพของการทบทวนแยกออกจากกันได้ง่าย ทีมลดเวลาถึงการทบทวนครั้งแรกลงครึ่งหนึ่งได้ด้วยการอนุมัติทุกอย่างทันทีที่เห็น และแดชบอร์ดจะแสดงชัยชนะขณะที่โค้ดเบสแย่ลง กฎของกูดฮาร์ตใช้ได้รุนแรงผิดปกติกับกลุ่มตัวชี้วัดนี้ (ดูหัวข้อ 1.2 “กฎของกูดฮาร์ตและจิตวิทยาของตัวชี้วัด”) เพราะตัวเลขเก็บถูก ทุกคนเห็น และเปลี่ยนได้ง่ายมากโดยไม่เปลี่ยนสิ่งที่ตั้งใจให้แทน ทุกข้อเสนอแนะด้านล่างเขียนโดยคำนึงถึงเรื่องนี้
ผู้เขียน (author) เปิดพูลรีเควสต์และ ผู้ทบทวน (reviewer) ประเมินมัน รอบการทบทวน (review round) คือหนึ่งวงของ “ผู้เขียนพุช ผู้ทบทวนตอบ” การทำซ้ำ (rework) คือการเปลี่ยนแปลงที่ทำหลังความเห็นจากการทบทวนหรือหลังการรวม เพื่อแก้สิ่งที่เวอร์ชันแรกผิด การรวมโค้ดอย่างต่อเนื่อง (continuous integration: CI) คือแนวปฏิบัติของการรวมงานเข้าสายร่วมบ่อย ๆ และตรวจสอบการรวมแต่ละครั้งโดยอัตโนมัติ ดูการรวมโค้ดอย่างต่อเนื่อง
ตัวชี้วัดทั้งหมดในหัวข้อนี้อธิบายทีมและคลังโค้ด ไม่เคยจัดอันดับผู้ทบทวนหรือผู้เขียน จำนวนการทบทวนระดับบุคคลดึงออกมาง่ายและน่าล่อใจที่จะใช้ และการทำเช่นนั้นเปลี่ยนแนวปฏิบัติการทำงานร่วมกันให้เป็นการแข่งขัน (ดูหัวข้อ 9.1 “สุขภาพของทีมและประสบการณ์ของนักพัฒนา”)
หลักการสำคัญ
- การรอครอบงำการทบทวน ในทีมส่วนใหญ่ ส่วนที่ใหญ่ที่สุดของเวลาทบทวนคือพูลรีเควสต์ที่นอนอยู่โดยไม่มีใครอ่าน ไม่ใช่การสนทนาเมื่อผู้ทบทวนเริ่มแล้ว วัดการรอก่อนวัดการสนทนา
- การเปลี่ยนแปลงเล็กถูกทบทวนเร็วกว่าและดีกว่า ขนาดเป็นหนึ่งในไม่กี่คันโยกที่ปรับปรุงทั้งความเร็วและความละเอียดพร้อมกัน เพราะผู้ทบทวนเก็บการเปลี่ยนแปลงเล็กไว้ในหัวได้
- ความเร็วโดยไม่มีการพิจารณาไม่ใช่การปรับปรุง ตัวชี้วัดความเร็วทุกตัวในหัวข้อนี้ต้องมีคู่ด้านคุณภาพ และอ่านคู่นั้นร่วมกัน
- การทบทวนเป็นกำลังการทำงานของทีม ไม่ใช่ของบุคคล ควรกระจายภาระข้ามทีม ตัวชี้วัดที่แสดงการกระจุกตัวชี้ไปที่ปัญหาการออกแบบในทีม ไม่เคยชี้ไปที่บุคคลที่ควรชมหรือตำหนิ
- การกระจายดีกว่าค่าเฉลี่ย เวลาทบทวนมีหางยาวของพูลรีเควสต์ที่ติด จึงรายงานค่ามัธยฐานและเปอร์เซ็นไทล์สูง (ดูหัวข้อ 1.6 “ความรู้ด้านสถิติสำหรับตัวชี้วัดบริการ”)
- นิยามนาฬิกาแล้วอย่าแตะต้อง ระบุว่านาฬิกาเริ่มและหยุดเมื่อใด เหตุการณ์ใดหยุดชั่วคราว และกิจกรรมอัตโนมัติใดไม่นับ และเขียนไว้ในที่ที่ข้อมูลอยู่ (ดูหัวข้อ 1.5 “แหล่งข้อมูลและการติดตั้งเครื่องมือวัด”)
- ตัวชี้วัดการทบทวนรับใช้ทีมที่เป็นเจ้าของงาน เป็นข้อมูลนำเข้าให้การทบทวนย้อนหลังของทีมเอง ไม่ใช่สกอร์การ์ดสำหรับคนอื่น
นิยามตัวชี้วัด
นาฬิกาด้านล่างสมมติว่าแพลตฟอร์มควบคุมเวอร์ชันบันทึกเวลาเหตุการณ์ของการเปิด การขอทบทวน ความเห็น การอนุมัติ การพุช และการรวม ฉบับร่าง พูลรีเควสต์ที่เปิดโดยบอต และพูลรีเควสต์ที่ปิดโดยไม่รวมไม่นับ เว้นแต่แถวระบุเป็นอย่างอื่น “ชั่วโมงทำงาน” หมายถึงชั่วโมงทำงานที่ทีมประกาศ พูลรีเควสต์ที่เปิดเย็นวันศุกร์จึงไม่สะสมการรอข้ามสุดสัปดาห์
| ตัวชี้วัด | นิยาม | สูตร | หน่วย | แหล่งข้อมูล | แนวปฏิบัติของ ITIL | ส่วนที่เทียบเท่าในแนวทางแบบคล่องตัว | รอบการวัด |
|---|---|---|---|---|---|---|---|
| เวลาถึงการทบทวนครั้งแรก | การรอระหว่างที่พูลรีเควสต์พร้อมให้ทบทวนกับการตอบสนองที่มีสาระครั้งแรกจากบุคคล | นาฬิกาเริ่มเมื่อพูลรีเควสต์พ้นสถานะฉบับร่างหรือเปิดแบบพร้อม หยุดที่ความเห็นทบทวน คำขอแก้ไข หรือการอนุมัติครั้งแรกโดยผู้ที่ไม่ใช่ผู้เขียน ไม่นับความเห็นของบอตและผู้เขียนและการเปลี่ยนป้ายล้วน ๆ รายงานค่ามัธยฐานและเปอร์เซ็นไทล์ที่ 85 เป็นชั่วโมงทำงาน | ชั่วโมงทำงาน | ประวัติเหตุการณ์ของแพลตฟอร์มควบคุมเวอร์ชัน | การพัฒนาและการจัดการซอฟต์แวร์ การเปิดทางให้เกิดการเปลี่ยนแปลง | ข้อตกลงการทำงานเรื่องการตอบสนองการทบทวน การไหลของงานระหว่างทำ | รายสัปดาห์ |
| รอบเวลาการทบทวน | เวลารวมจากพร้อมให้ทบทวนถึงการรวม | นาฬิกาเริ่มเมื่อพูลรีเควสต์พร้อมให้ทบทวน หยุดที่การรวม ไม่นับพูลรีเควสต์ที่ปิดโดยไม่รวมแต่นับแยกต่างหาก รายงานค่ามัธยฐานและเปอร์เซ็นไทล์ที่ 85 เป็นชั่วโมงทำงาน | ชั่วโมงทำงาน | ประวัติเหตุการณ์ของแพลตฟอร์มควบคุมเวอร์ชัน | การจัดการการติดตั้งใช้งาน การเปิดทางให้เกิดการเปลี่ยนแปลง | รอบเวลาของขั้นทบทวนบนบอร์ดของทีม | รายสัปดาห์ |
| ขนาดพูลรีเควสต์ | ปริมาณการเปลี่ยนแปลงในพูลรีเควสต์ | บรรทัดที่เพิ่มบวกบรรทัดที่ลบ ไม่นับไฟล์ที่สร้างอัตโนมัติ ไฟล์ล็อก โค้ดของผู้อื่นที่รวมมา และการเปลี่ยนชื่อล้วน ๆ ตามรายการยกเว้นของคลัง รายงานค่ามัธยฐานและเปอร์เซ็นไทล์ที่ 85 ต่อพูลรีเควสต์ที่รวมแล้ว | บรรทัดที่เปลี่ยน | สถิติความแตกต่างของแพลตฟอร์มควบคุมเวอร์ชัน | การพัฒนาและการจัดการซอฟต์แวร์ | ขนาดชุดงานเล็ก การหั่นเรื่องราว | รายสัปดาห์ |
| รอบการทบทวน | จำนวนวงของการพุชของผู้เขียนและการตอบของผู้ทบทวนก่อนรวม | จำนวนวง “ขอแก้ไข” หรือความเห็นแล้วพุชที่แตกต่างกันต่อพูลรีเควสต์ที่รวมแล้ว การส่งครั้งแรกเป็นรอบศูนย์ และไม่นับความล้มเหลวของการตรวจสอบอัตโนมัติ รายงานค่ามัธยฐานและเปอร์เซ็นไทล์ที่ 85 | จำนวน | เหตุการณ์ทบทวนและพุชของแพลตฟอร์มควบคุมเวอร์ชัน | การปรับปรุงอย่างต่อเนื่อง การพัฒนาและการจัดการซอฟต์แวร์ | สัญญาณการทำซ้ำในขั้นทบทวน นิยามของเสร็จ | รายสัปดาห์ |
| การกระจุกตัวของภาระการทบทวน | งานทบทวนกระจายข้ามทีมไม่เท่ากันเพียงใด | สัดส่วนของการทบทวนที่ทีมทำเสร็จซึ่งจัดการโดยผู้ทบทวนที่ยุ่งที่สุดสองคนในช่วงเลื่อน 4 สัปดาห์ ไม่นับการทบทวนพูลรีเควสต์ของตนเองและการทบทวนของบอต รายงานสำหรับทีม ไม่เคยรายงานตามชื่อ | ร้อยละ | เหตุการณ์ทบทวนของแพลตฟอร์มควบคุมเวอร์ชัน รวมเป็นระดับทีม | การปรับปรุงอย่างต่อเนื่อง การจัดการความรู้ | การเป็นเจ้าของโค้ดร่วม การเป็นเจ้าของร่วมกัน | รายเดือน |
| จำนวนพูลรีเควสต์ที่ค้าง | พูลรีเควสต์ที่เปิดอยู่นานกว่าขีดจำกัดที่ทีมตกลง | พูลรีเควสต์ที่ยังเปิดอยู่และไม่ใช่ฉบับร่างซึ่งอายุตั้งแต่พร้อมให้ทบทวนเกินขีดจำกัดของทีม นับ ณ เวลาภาพรวม ไม่นับฉบับร่าง | จำนวน | รายการพูลรีเควสต์ที่เปิดอยู่ของแพลตฟอร์มควบคุมเวอร์ชัน | การเปิดทางให้เกิดการเปลี่ยนแปลง การปรับปรุงอย่างต่อเนื่อง | อายุของรายการงาน ขีดจำกัด WIP | รายสัปดาห์ |
| อัตราการแก้ไขหลังการรวม | สัดส่วนของพูลรีเควสต์ที่รวมแล้วซึ่งตามด้วยการเปลี่ยนแปลงแก้ไขในเวลาไม่นาน | พูลรีเควสต์ที่รวมแล้วซึ่งตามด้วยการแก้ไข การย้อนกลับ หรือการแก้ไขด่วนที่เชื่อมโยงกับการเปลี่ยนแปลงเดียวกันภายใน 14 วัน / พูลรีเควสต์ที่รวมในช่วงเวลา ไม่นับงานติดตามผลที่วางแผนไว้และติดป้ายเช่นนั้น | ร้อยละ | ประวัติการควบคุมเวอร์ชัน ประเด็นที่เชื่อมโยง และระเบียนเหตุขัดข้องหรือการเปลี่ยนแปลง | การเปิดทางให้เกิดการเปลี่ยนแปลง การจัดการเหตุขัดข้อง | คุณภาพที่สร้างมาในตัว นิยามของเสร็จ | รายเดือน |
เวลาถึงการทบทวนครั้งแรกเป็นคันโยกที่ใหญ่ที่สุดและเป็นตัวชี้วัดที่ทีมส่วนใหญ่ควรเริ่มด้วย รอบเวลาการทบทวนเป็นการวัดผลลัพธ์ของมันและเป็นส่วนประกอบของลีดไทม์ที่ยาวกว่าที่กล่าวถึงในหัวข้อ 2.2 หน้าต่าง 14 วันและขีดจำกัดค้างเป็นตัวอย่าง แต่ละทีมเลือกค่าที่เหมาะกับจังหวะการปล่อยรุ่นของตนและเขียนไว้ เมื่อตัวเลขป้อนเข้าสู่ภาพการส่งมอบที่กว้างกว่า กลุ่มตัวชี้วัด DORA (ดูหัวข้อ 2.8 “ตัวชี้วัด DORA”) และการวัดความล้มเหลวของการเปลี่ยนแปลง (ดูหัวข้อ 4.4 “ความล้มเหลวของการเปลี่ยนแปลงและการทำซ้ำ”) เข้ามารับช่วง
ข้อเสนอแนะ
วัดการรอก่อนวัดงาน
1. เริ่มด้วยเวลาถึงการทบทวนครั้งแรก โดยทั่วไปนี่คือส่วนที่ใหญ่ที่สุดของเวลาทบทวนและปรับปรุงได้ถูกที่สุด ติดตั้งเครื่องมือวัดจากประวัติเหตุการณ์ของแพลตฟอร์มเพื่อให้ไม่มีใครต้องป้อนอะไร รายงานค่ามัธยฐานและเปอร์เซ็นไทล์สูง เพราะค่ามัธยฐานสามชั่วโมงกับเปอร์เซ็นไทล์ที่ 95 สี่วันหมายความว่าบางการเปลี่ยนแปลงถูกลืม
2. ไม่นับบอตและฉบับร่างในนาฬิกา และบอกให้ชัด การตรวจสอบอัตโนมัติ บอตอัปเดตความเกี่ยวเนื่อง และเครื่องมือจัดรูปแบบสร้างความเห็นภายในไม่กี่วินาที และการนับสิ่งเหล่านี้ทำให้การรอดูยอดเยี่ยม เริ่มนาฬิกาเมื่อผู้เขียนทำเครื่องหมายว่าการเปลี่ยนแปลงพร้อม ไม่ใช่เมื่อกิ่งถูกพุชครั้งแรก เผยแพร่กฎเหล่านี้ไว้ข้างแผนภูมิ
3. ใช้ชั่วโมงทำงาน และเขียนปฏิทินของทีม พูลรีเควสต์ที่เปิดดึกวันศุกร์ไม่ควรแบกการรอข้ามสุดสัปดาห์ ทีมที่กระจายข้ามเขตเวลาต้องมีกฎว่าชั่วโมงของใครนับ และคำตอบที่ตรงไปตรงมามักเป็นว่าต้นทุนการส่งต่อข้ามเขตเวลาคือสิ่งที่ควรเห็น ระบุทางเลือกและรักษาให้คงที่
ทำให้งานทบทวนได้
4. รักษาพูลรีเควสต์ให้เล็ก และถือขนาดเป็นนิสัยของทีม ติดตามค่ามัธยฐานและเปอร์เซ็นไทล์ที่ 85 ของขนาด และดูพูลรีเควสต์ใหญ่เป็นชุดแทนที่จะเป็นความล้มเหลวรายตัว ทีมมักพบว่าการเปลี่ยนแปลงใหญ่มาจากสาเหตุไม่กี่อย่าง คืองานไม่ได้หั่นละเอียดพอ ผสมการปรับโครงสร้างโค้ดกับพฤติกรรมใหม่ หรือรอนานเกินไปกว่าจะรวม หั่นงานให้แต่ละพูลรีเควสต์ทำสิ่งเดียว ซึ่งตรงกับหลักการชุดงานเล็กที่อยู่เบื้องหลังการพัฒนาแบบทรังก์เป็นฐานและการติดตั้งใช้งานบ่อย
5. อย่าตั้งเพดานขนาดแบบตายตัวเป็นเป้าหมาย ขีดจำกัดเช่น “ไม่เกิน 400 บรรทัด” เชื้อเชิญให้แบ่งการเปลี่ยนแปลงเป็นชิ้นเทียมที่แต่ละชิ้นอ่านไม่ได้หรือทำให้บิลด์พังเมื่อรวมโดด ๆ ใช้ขนาดเป็นตัวจุดประเด็นสนทนาในการทบทวนย้อนหลัง และให้เทคนิคการหั่นแก่ทีม เช่น ฟีเจอร์ทอกเกิล การปรับโครงสร้างโค้ดเตรียมการในพูลรีเควสต์ของมันเอง และการรวมหลังธง
6. ทำให้คำขอทบทวนชัดเจน พูลรีเควสต์ที่ไม่ระบุผู้ทบทวนรออาสาสมัคร และอาสาสมัครหายาก ตกลงว่าใครถูกขอ ทีมได้รับแจ้งอย่างไร และความคาดหวังเรื่องการตอบสนองคืออะไร ในข้อตกลงการทำงาน ตารางเวรทบทวนร่วมหรือช่วงทบทวนรายวันมักลดการรอได้มากกว่าการตั้งค่าเครื่องมือใด ๆ
กระจายภาระและความรู้
7. เฝ้าดูการกระจุกตัวของภาระเป็นความเสี่ยงระดับทีม หากสองคนจัดการการทบทวนส่วนใหญ่ ความพร้อมของพวกเขาจำกัดการไหลของงานของทีมและการไม่อยู่ของพวกเขาหยุดมัน ทบทวนตัวชี้วัดการกระจุกตัวทุกเดือน และลงมือผ่านการออกแบบของทีม คือหมุนเวียนผู้ทบทวนเริ่มต้น จับคู่สมาชิกใหม่กับผู้มีประสบการณ์ และเขียนส่วนของโค้ดที่มีเพียงคนเดียวทบทวนได้ ห้ามเผยแพร่ตารางอันดับรายบุคคล
8. ใช้การทบทวนเพื่อแบ่งปันความรู้ และปกป้องจุดประสงค์นั้น คุณค่าระยะยาวของการทบทวนรวมการเรียนรู้ การเป็นเจ้าของร่วม และสไตล์ที่สม่ำเสมอ นอกเหนือจากการตรวจจับข้อบกพร่อง การเขียนโปรแกรมเป็นคู่และการเขียนโปรแกรมเป็นกลุ่มย้ายการแลกเปลี่ยนบางส่วนไปเร็วขึ้นในกระบวนการ เมื่อมีคู่ทำงานกับการเปลี่ยนแปลงแล้ว การทบทวนที่เบากว่าก็สมเหตุสมผล ให้เป็นการตัดสินใจของทีม เขียนไว้ในข้อตกลงการทำงาน เพื่อให้ “ทำเป็นคู่แล้ว จึงทบทวนเบา” เป็นกฎที่มองเห็นได้ ไม่ใช่ข้ออ้าง
ควบคุมการทบทวนเอง
9. ให้ระบบอัตโนมัติจัดการสิ่งที่มันทำได้ดี การจัดรูปแบบ ลินต์ และการตรวจสอบพื้นฐานอยู่ในสายงาน เพื่อให้ความสนใจของมนุษย์ไปที่การออกแบบ ความถูกต้อง และความเสี่ยง การวิเคราะห์โปรแกรมแบบสถิตและการทดสอบอัตโนมัติลดจำนวนรอบทบทวนที่ไม่สำคัญ รอบที่เหลือจึงบอกมากกว่าเกี่ยวกับการสนทนาเรื่องการออกแบบและน้อยกว่าเกี่ยวกับความเห็นต่างด้านสไตล์
10. อ่านรอบการทบทวนเป็นสัญญาณเรื่องความชัดเจน ไม่ใช่การนับความผิด หลายรอบอาจหมายถึงความต้องการไม่ชัด ผู้เขียนขาดบริบท ผู้ทบทวนขอการเปลี่ยนตามรสนิยม หรือการเปลี่ยนแปลงใหญ่ ศูนย์รอบในทุกพูลรีเควสต์อาจหมายถึงงานยอดเยี่ยมหรือไม่มีใครดู สุ่มพูลรีเควสต์ไม่กี่รายการที่มีรอบมากหรือน้อยผิดปกติและอ่านร่วมกันเป็นทีม
จับคู่ความเร็วกับคุณภาพ และทำให้เวลามองเห็นได้
11. แสดงคู่ด้านคุณภาพข้างความเร็วของการทบทวนเสมอ อัตราการแก้ไขหลังการรวม เหตุขัดข้องที่เชื่อมโยงกับการเปลี่ยนแปลงล่าสุด และสัดส่วนของข้อบกพร่องที่พบหลังการปล่อยเป็นคู่ตามธรรมชาติ (ดูหัวข้อ 4.4 “ความล้มเหลวของการเปลี่ยนแปลงและการทำซ้ำ”) หากเวลาทบทวนดีขึ้นขณะที่อัตราการแก้ไขแย่ลง ทีมแลกหลักประกันกับความเร็ว และการแก้ไขคือการสนทนา ไม่ใช่เป้าหมาย แสดงทั้งสองบนแผนภูมิเดียวกัน
12. เชื่อมการทบทวนกับภาพการไหลของงานและงานที่ไม่ได้วางแผน การทบทวนที่เร็วขึ้นช่วยก็ต่อเมื่อขั้นถัดไปไม่เพียงต่อคิวงาน (ดูหัวข้อ 2.3 “งานระหว่างทำและการต่อคิว”) คำขอทบทวนเร่งด่วนที่ขัดจังหวะงานที่วางแผนไว้มีต้นทุนของตนเอง (ดูหัวข้อ 2.9 “งานปฏิบัติการและงานที่ไม่ได้วางแผน”)
ช่องทางการบิดเบือนและมาตรการป้องกัน
| ตัวชี้วัด | วิธีที่ถูกบิดเบือน | ตัวชี้วัดหรือแนวปฏิบัติป้องกันที่จับคู่ |
|---|---|---|
| เวลาถึงการทบทวนครั้งแรก | โพสต์ “ดูดี” สั้น ๆ หรืออีโมจิเป็นการตอบครั้งแรก มอบหมายบอตหรือผู้ทบทวนที่เป็นมิตร ทำเครื่องหมายพูลรีเควสต์ว่าพร้อมหลังจากมีผู้ตกลงล่วงหน้าว่าจะดูเท่านั้น | อัตราการแก้ไขหลังการรวม สุ่มตรวจการอนุมัติที่ไม่มีความเห็น กำหนดในข้อตกลงการทำงานว่าการตอบครั้งแรกต้องมีสาระ |
| รอบเวลาการทบทวน | รวมโดยไม่รอการทบทวน แบ่งการเปลี่ยนแปลงเป็นชิ้นเล็กเพื่อผ่านเร็วขึ้น ปิดและเปิดพูลรีเควสต์ใหม่เพื่อรีเซ็ตนาฬิกา | นับพูลรีเควสต์ที่ปิดแล้วเปิดใหม่ รอบการทบทวน อัตราการแก้ไขหลังการรวม กฎกิ่งที่ป้องกันซึ่งต้องมีการอนุมัติ |
| ขนาดพูลรีเควสต์ | ยกเว้นไฟล์จากการนับ แบ่งการเปลี่ยนแปลงเดียวเป็นชิ้นที่เข้าใจแยกกันไม่ได้ ขยายขนาดด้วยโค้ดที่สร้างอัตโนมัติ | ทบทวนกฎยกเว้นทุกไตรมาส ตรวจว่าชิ้นที่แบ่งบิลด์และผ่านการทดสอบเมื่อแยก อ่านตัวอย่างที่เล็กที่สุดและใหญ่ที่สุด |
| รอบการทบทวน | อนุมัติตั้งแต่รอบแรกเพื่อให้จำนวนต่ำ ย้ายการสนทนาไปแชตเพื่อไม่ทิ้งร่องรอย ผู้เขียนพุชการแก้ไขหลายอย่างในคอมมิตเดียวเพื่อซ่อนรอบ | อัตราการแก้ไขหลังการรวม สุ่มตรวจพูลรีเควสต์ที่ศูนย์รอบ เก็บการสนทนาไว้ในพูลรีเควสต์ |
| การกระจุกตัวของภาระการทบทวน | แบ่งการทบทวนเป็นการอนุมัติเล็ก ๆ จำนวนมากเพื่อกระจายการนับ มอบหมายการทบทวนให้ผู้ที่มีเวลาว่างแต่ไม่มีความรู้ | ทบทวนความรู้ของผู้ทบทวนสำหรับส่วนที่เสี่ยง เฝ้าดูอัตราการแก้ไขหลังการรวมตามส่วน เก็บตัวชี้วัดไว้ที่ระดับทีม |
| จำนวนพูลรีเควสต์ที่ค้าง | ปิดพูลรีเควสต์ที่ค้างโดยไม่รวม แปลงเป็นฉบับร่างเพื่อซ่อน เพิ่มขีดจำกัดที่ค้าง | จำนวนพูลรีเควสต์ที่ปิดโดยไม่รวม จำนวนฉบับร่างที่ค้างนาน ทบทวนขีดจำกัดกับทีมทุกไตรมาส |
| อัตราการแก้ไขหลังการรวม | บันทึกการแก้ไขภายใต้รายการงานใหม่ที่ไม่มีการเชื่อมโยง ติดป้ายงานแก้ไขเป็นงานติดตามผลที่วางแผนไว้ หลีกเลี่ยงตัวชี้วัดด้วยการเลื่อนการแก้ไขให้พ้นหน้าต่าง | เปรียบเทียบกับข้อมูลเหตุขัดข้องและความล้มเหลวของการเปลี่ยนแปลง สุ่มรายการติดตามผล ตรวจสอบป้ายที่ใช้ |
การอ่านค่าที่ดีคือการอ่านที่สงบ เวลาถึงการทบทวนครั้งแรกสั้นและส่วนหางสั้นด้วย จึงไม่มีพูลรีเควสต์ที่รอเป็นวัน ขนาดอยู่ในช่วงที่ทีมอ่านง่าย โดยมีการเปลี่ยนแปลงใหญ่ไม่กี่รายการที่ทีมอธิบายได้ รอบการทบทวนต่ำแต่ไม่เป็นศูนย์ การกระจุกตัวของภาระปานกลาง จำนวนที่ค้างน้อย และอัตราการแก้ไขหลังการรวมคงที่ เมื่อตัวเลขหนึ่งดีขึ้นอย่างมาก ควรมีผู้ตรวจว่ามาตรการป้องกันที่จับคู่ไม่ได้เคลื่อนไปในทางที่ผิด
ข้อแลกเปลี่ยน: ข้อดีและข้อเสีย
| แนวทาง | จุดแข็ง | จุดอ่อน |
|---|---|---|
| การทบทวนเร็วพร้อมความคาดหวังการตอบสนองที่เข้มงวด | วงข้อเสนอแนะสั้น ผู้เขียนสูญเสียบริบทน้อยลง งานระหว่างทำต่ำลง | แรงกดดันให้อนุมัติเร็ว ขัดจังหวะงานที่ต้องจดจ่อ |
| การทบทวนช้าและละเอียด | อ่านการออกแบบและความเสี่ยงอย่างระมัดระวัง ถ่ายทอดความรู้ได้แข็งแรงกว่า | รอบเวลายาวขึ้น ชุดงานใหญ่สะสม ผู้เขียนไปทำอย่างอื่นและสูญเสียบริบท |
| พูลรีเควสต์เล็ก | อ่านและย้อนกลับง่ายกว่า การไหลของงานราบรื่นกว่า | ภาระต่อการเปลี่ยนแปลงมากขึ้น อาจแบ่งฟีเจอร์เป็นขั้นที่สับสน |
| พูลรีเควสต์ใหญ่ | ส่งต่อน้อยลง เห็นฟีเจอร์ทั้งหมดพร้อมกัน | การทบทวนตื้น ย้อนกลับยากขึ้น รอนาน |
| ต้องมีการอนุมัติจากเจ้าของที่ระบุชื่อ | ความรับผิดชอบชัดเจนสำหรับส่วนที่เสี่ยง สนับสนุนการอนุมัติการเปลี่ยนแปลง | สร้างคอขวดและจุดล้มเหลวเดี่ยว |
| การตรวจสอบอัตโนมัติก่อนการทบทวนโดยมนุษย์ | ปลดปล่อยผู้คนสำหรับการออกแบบและความเสี่ยง สม่ำเสมอ | อาจสร้างความมั่นใจผิด ๆ ต้องดูแลรักษา |
ไม่มีนโยบายเดียวที่ชนะ เป้าหมายคือทำให้การรอสั้นลงโดยรักษาการพิจารณาไว้ และเส้นทางปกติคือการเปลี่ยนแปลงที่เล็กลง ความคาดหวังการทบทวนที่ชัดเจน ระบบอัตโนมัติที่แข็งแรงสำหรับการตรวจสอบประจำ และข้อตกลงของทีมว่าการทบทวนที่ดีเป็นอย่างไร ตัวชี้วัดการทบทวนมีประโยชน์ที่สุดเมื่อเป็นคำถามสำหรับการทบทวนย้อนหลัง และมีประโยชน์น้อยที่สุดเมื่อเป็นเป้าหมาย
คำถามสำหรับอภิปรายกับทีม
1. พูลรีเควสต์ใช้ชีวิตส่วนใหญ่ที่ใด รอหรือถูกทบทวน ขอให้ทีมเดาก่อนดูข้อมูล แล้วแสดงการแบ่งระหว่างเวลาถึงการทบทวนครั้งแรกกับเวลาที่เหลือจนถึงการรวม กลุ่มส่วนใหญ่แปลกใจที่การรอมีมากเพียงใด ผู้อำนวยการประชุมควรจดว่าการคาดเดาใดผิดและถามว่าการคาดเดาที่ผิดแต่ละอันบอกอะไรเกี่ยวกับวิธีที่ทีมประสบการทบทวน จบด้วยการเปลี่ยนแปลงหนึ่งอย่างที่จัดการการรอที่ใหญ่ที่สุด
2. การทบทวนที่ดีเป็นอย่างไรในทีมนี้ และคนนอกจะบอกได้อย่างไร ระบุพฤติกรรมที่ทีมให้คุณค่า เช่น ถามเรื่องการออกแบบ ตรวจการทดสอบ และอธิบายเหตุผลของคำขอ แล้วถามว่าพฤติกรรมใดทิ้งร่องรอยที่มองเห็นได้ในพูลรีเควสต์ อภิปรายวิธีแยกการตอบครั้งแรกที่มีสาระออกจากการตอบพอเป็นพิธีโดยไม่ตรวจตราบุคคล ตกลงคำอธิบายสั้น ๆ ที่เขียนไว้เพื่อใส่ในข้อตกลงการทำงาน
3. ใหญ่แค่ไหนจึงใหญ่เกินไปสำหรับเรา และเราทำอย่างไรเมื่องานใหญ่จริง ๆ ดูการกระจายของขนาดและเลือกพูลรีเควสต์ที่ใหญ่ที่สุดไม่กี่รายการ ถามว่าแต่ละรายการใหญ่เพราะอะไรและหั่นได้หรือไม่ อภิปรายเทคนิค เช่น ฟีเจอร์ทอกเกิล การปรับโครงสร้างโค้ดเตรียมการ และการรวมหลังธง ผู้อำนวยการประชุมควรต้านทานการตั้งขีดจำกัดเป็นตัวเลข และตกลงนิสัยที่ทีมจะลองหนึ่งเดือนแทน
4. ใครทบทวนโค้ดที่เสี่ยงที่สุดของเรา และจะเกิดอะไรขึ้นเมื่อพวกเขาไม่อยู่ แมปส่วนของโค้ดกับผู้ที่ทบทวนได้ดี ดูการกระจุกตัวของภาระและส่วนที่มีผู้ทบทวนที่มีคุณสมบัติเพียงคนเดียว อภิปรายวิธีสร้างผู้ทบทวนคนที่สองในแต่ละส่วนผ่านการจับคู่หรือหมุนเวียนการมอบหมาย รักษาการสนทนาไว้ที่ความยืดหยุ่นของทีม ไม่ใช่การจัดอันดับภาระงานของใคร
5. หากความเร็วการทบทวนของเราเพิ่มเป็นสองเท่าในวันพรุ่งนี้ เราอยากให้อะไรเป็นจริงเรื่องคุณภาพ ขอให้กลุ่มระบุสัญญาณคุณภาพที่จะเฝ้าดู เช่น การแก้ไขหลังการรวม เหตุขัดข้องที่เชื่อมโยงกับการเปลี่ยนแปลงล่าสุด หรือจำนวนการย้อนกลับ ตรวจว่าสัญญาณเหล่านั้นมองเห็นได้ข้างแผนภูมิความเร็วในขณะนี้หรือไม่ อภิปรายว่าอะไรจะเป็นสัญญาณแรกว่าความเร็วถูกซื้อด้วยการแลกกับการพิจารณา ตกลงว่าจะแสดงคู่ด้านคุณภาพใดบนแดชบอร์ด
6. ตัวเลขการทบทวนใดที่เราจะถูกล่อให้ปรับปรุงในทางที่ไม่ช่วยอะไร ไล่ทีละตัวชี้วัดและถามว่าผู้ที่อยู่ภายใต้แรงกดดันจะทำให้ดูดีขึ้นโดยไม่ทำให้อะไรดีขึ้นได้อย่างไร เปรียบเทียบคำตอบกับตารางการบิดเบือนด้านบนและเพิ่มแนวคิดของทีมเอง เป้าหมายคือตั้งชื่อความเสี่ยงก่อนที่จะเกิด ตกลงว่ามาตรการป้องกันใดจะทบทวนควบคู่กับแต่ละตัวชี้วัด
สี่มุมมอง
ทีมผลิตภัณฑ์และการส่งมอบ
ทีมส่งมอบเป็นเจ้าของกระบวนการทบทวนและควรเป็นเจ้าของตัวชี้วัดของมัน ได้ประโยชน์สูงสุดจากการทำให้การรอสั้นลงด้วยข้อตกลงง่าย ๆ ได้แก่ ช่วงทบทวนรายวัน กระบวนการขอที่ชัดเจน และการเปลี่ยนแปลงขนาดเล็ก ควรใช้ตัวเลขในการทบทวนย้อนหลัง รักษางานระหว่างทำให้ต่ำ และต้านทานแรงล่อใจที่จะปรับแผนภูมิเดียวให้เหมาะสม การทบทวนยังเป็นที่ที่สมาชิกใหม่เรียนรู้โค้ดเบส จึงควรปกป้องจุดประสงค์นั้น
ทีมบริการและปฏิบัติการ
ทีมปฏิบัติการพบการทบทวนเมื่อโค้ดโครงสร้างพื้นฐาน การกำหนดค่า และระบบอัตโนมัติของคู่มือปฏิบัติการถูกเปลี่ยนผ่านพูลรีเควสต์ สำหรับพวกเขา การทบทวนมักเป็นส่วนหนึ่งของวิธีที่การเปลี่ยนแปลงมาตรฐานได้รับการอนุมัติและมีหลักฐาน (ดูหัวข้อ 4.3 “ตัวชี้วัดการสนับสนุนการเปลี่ยนแปลง”) ควรตกลงว่าการเปลี่ยนแปลงใดต้องการการทบทวนโดยบุคคลที่สอง การแก้ไขด่วนถูกทบทวนเร็วเพียงใด และการเปลี่ยนแปลงฉุกเฉินถูกทบทวนภายหลังอย่างไร เพื่อให้การแก้ไขที่เร่งรีบยังถูกตรวจสอบ การทบทวนบางเบาของการเปลี่ยนแปลงที่เสี่ยงจะปรากฏทีหลังเป็นเหตุขัดข้อง
ภาวะผู้นำและการกำกับดูแล
ผู้นำควรถือตัวชี้วัดการทบทวนเป็นสัญญาณเรื่องสุขภาพของทีมและการไหลของงาน ไม่ใช่คะแนนผลิตภาพ ควรขอการวัดคุณภาพที่จับคู่เมื่อใดก็ตามที่รายงานตัวเลขความเร็ว สนับสนุนเวลาที่การทบทวนอย่างระมัดระวังต้องใช้ และหลีกเลี่ยงการเปรียบเทียบทีมด้วยเวลาทบทวนดิบ เพราะคลังโค้ดและความเสี่ยงต่างกัน หน่วยกำกับดูแลใช้หลักฐานการทบทวนเป็นส่วนหนึ่งของหลักประกันการเปลี่ยนแปลงได้ หากยอมรับว่ากระบวนการทบทวนที่มีเอกสารและสุ่มตัวอย่างแข็งแรงกว่าการนับการอนุมัติ
ลูกค้าและผู้ใช้
ลูกค้าไม่เห็นพูลรีเควสต์ แต่รู้สึกถึงผลลัพธ์ คือการแก้ไขมาถึงเร็วเพียงใดและการปล่อยรุ่นนำข้อบกพร่องใหม่มาบ่อยเพียงใด การรอทบทวนที่สั้นช่วยให้การแก้ไขเร่งด่วนถึงพวกเขาเร็วขึ้น และการทบทวนอย่างรอบคอบช่วยกันข้อผิดพลาดออกไปจากพวกเขา เมื่อบริการมีประวัติการปล่อยรุ่นหรือข้อบกพร่องที่เผยแพร่ ลูกค้าได้ประโยชน์เมื่อทีมแสดงการย้อนกลับและการแก้ไขซ้ำที่ลดลงตามเวลา
ในทางปฏิบัติ: ตัวอย่าง ITIL แบบคล่องตัว
แผนกไอทีของโรงพยาบาลประจำภูมิภาคแห่งหนึ่งดำเนินบริการเว็บนัดหมายผู้ป่วย สร้างโดยทีมผลิตภัณฑ์เจ็ดคนและดำเนินการด้วยกลุ่มวิศวกรรมความน่าเชื่อถือของไซต์ขนาดเล็ก ตัวเลขทั้งหมดในตัวอย่างนี้เป็นตัวอย่างเพื่ออธิบาย
ในการทบทวนรายไตรมาส ทีมพบว่ารอบเวลาการทบทวนมีค่ามัธยฐาน 26 ชั่วโมงทำงานและเปอร์เซ็นไทล์ที่ 85 ที่ 71 ชั่วโมงทำงาน (ตัวอย่างเพื่ออธิบาย) การแยกรอบแสดงว่าค่ามัธยฐานของเวลาถึงการทบทวนครั้งแรกคือ 19 ชั่วโมงทำงาน ความล่าช้าส่วนใหญ่จึงเป็นการรอ ขนาดพูลรีเควสต์มีค่ามัธยฐาน 180 บรรทัดและเปอร์เซ็นไทล์ที่ 85 ที่ 900 บรรทัด (ตัวอย่างเพื่ออธิบาย) และผู้ทบทวนที่ยุ่งที่สุดสองคนจัดการร้อยละ 68 ของการทบทวน (ตัวอย่างเพื่ออธิบาย) อัตราการแก้ไขหลังการรวมอยู่ที่ร้อยละ 9 (ตัวอย่างเพื่ออธิบาย)
ทีมทำข้อตกลงสามอย่าง ตั้งช่วงทบทวนรายวัน 30 นาที เขียนความคาดหวังการตอบครั้งแรกภายในหนึ่งวันทำการไว้ในข้อตกลงการทำงาน และหมุนเวียนหน้าที่ “ทบทวนก่อน” ทุกสัปดาห์ พวกเขายังใช้นิสัยการหั่นสำหรับงานใหญ่ โดยใช้ฟีเจอร์ทอกเกิลเพื่อให้ฟีเจอร์ที่ยังไม่ครบรวมได้อย่างปลอดภัย พวกเขาไม่ตั้งขีดจำกัดขนาดหรือเป้าหมายสำหรับเวลาถึงการทบทวนครั้งแรก
สองเดือนต่อมา ค่ามัธยฐานของเวลาถึงการทบทวนครั้งแรกลดเหลือ 6 ชั่วโมงทำงานและเปอร์เซ็นไทล์ที่ 85 ของรอบเวลาการทบทวนลดเหลือ 34 ชั่วโมงทำงาน (ตัวอย่างเพื่ออธิบาย) การกระจุกตัวของภาระลดเหลือร้อยละ 52 (ตัวอย่างเพื่ออธิบาย) และอัตราการแก้ไขหลังการรวมคงที่ที่ร้อยละ 9
จากนั้นทีมจับความเสี่ยงของการบิดเบือนได้ การสุ่มตรวจการอนุมัติแสดงว่าประมาณหนึ่งในสามของการตอบครั้งแรกมาถึงภายในไม่กี่นาทีและเขียนเพียง “LGTM” กับการเปลี่ยนแปลงที่แตะตรรกะการเตือนนัดหมาย ผลประโยชน์ด้านความเร็วเป็นของจริงบางส่วนและเป็นตรายางบางส่วน อัตราการแก้ไขหลังการรวมยังไม่ขยับเพราะโค้ดที่ได้รับผลกระทบทำงานตามรอบรายเดือน ทีมเปลี่ยนข้อตกลงการทำงานให้การตอบครั้งแรกต้องมีคำถาม ความเห็นเกี่ยวกับส่วนเฉพาะของการเปลี่ยนแปลง หรือหมายเหตุที่ชัดเจนว่าตรวจอะไร และเพิ่มสัดส่วนที่สุ่มของการอนุมัติที่ไม่มีความเห็นลงในแผนภูมิการทบทวน พวกเขายังตกลงว่าการเปลี่ยนแปลงตรรกะการเตือนที่หันหน้าสู่ผู้ป่วยต้องมีผู้ทบทวนสองคน โดยหนึ่งคนมาจากกลุ่มปฏิบัติการ การตัดสินใจพร้อมเหตุผลลงในบันทึกการตัดสินใจของทีม
มุมมองตามประเภทองค์กร
สตาร์ทอัป ทีมเล็กทบทวนได้ในไม่กี่นาทีเพราะทุกคนรู้จักโค้ด และความเสี่ยงหลักคือการข้ามการทบทวนเมื่อเวลาไม่พอ เก็บตัวชี้วัดให้น้อย เวลาถึงการทบทวนครั้งแรกและขนาดก็เพียงพอ สร้างนิสัยการเปลี่ยนแปลงเล็กแต่เนิ่น ๆ เพราะนำมาใช้ยากขึ้นมากเมื่อโค้ดเบสและทีมโต
ธุรกิจขนาดเล็ก มักมีนักพัฒนาหนึ่งหรือสองคนหรือผู้ให้บริการภายนอกดูแลซอฟต์แวร์ การทบทวนอาจโดยเพื่อนร่วมงานคนเดียวหรือโดยบุคลากรของผู้ให้บริการเอง ถามผู้ให้บริการว่าทบทวนอย่างไรและแบ่งปันข้อมูลพูลรีเควสต์ได้หรือไม่ และเก็บบันทึกง่าย ๆ ว่าการเปลี่ยนแปลงใดถูกทบทวนโดยใคร เพราะการทบทวนเป็นการตรวจสอบหลักกันความผิดพลาดในทีมเล็ก
องค์กรขนาดใหญ่ หลายทีม คลังโค้ด และกฎการอนุมัติสร้างความแตกต่างกว้าง ทำให้นิยามนาฬิกาและรายการยกเว้นเป็นมาตรฐานเพื่อให้ข้อมูลแพลตฟอร์มเปรียบเทียบกันได้ แต่ไม่จัดอันดับทีมด้วยเวลาทบทวนดิบ เพราะความเสี่ยงและโค้ดเบสต่างกัน เฝ้าดูข้อกำหนดการทบทวนที่ถูกกำหนดเพื่อการตรวจสอบซึ่งเพิ่มการรอโดยไม่เพิ่มการพิจารณา และมองหาโอกาสแทนการอนุมัติด้วยมือด้วยการตรวจสอบอัตโนมัติและการทบทวนแบบสุ่มตัวอย่าง
หน่วยงานภาครัฐและภาคสาธารณะ การแบ่งแยกหน้าที่ ร่องรอยการตรวจสอบ และกฎการจัดซื้อจัดจ้างมักต้องการการอนุมัติอิสระสำหรับการเปลี่ยนแปลง ถือกฎเหล่านั้นเป็นข้อมูลนำเข้าการออกแบบ บันทึกว่าใครอนุมัติอะไรและเมื่อใด และวัดการรอที่เกิดขึ้น เมื่อผู้ให้บริการเขียนโค้ด ให้ระบุหลักฐานการทบทวนและการเข้าถึงข้อมูลในสัญญา (ดูหัวข้อ 8.5 “การรายงานตามข้อกำหนดและต่อภาครัฐ”)
กรณีทางธุรกิจ: แรงจูงใจ ROI และ TCO
แรงจูงใจคือทำให้ส่วนของการส่งมอบที่ทั้งช้าและควบคุมได้สั้นลง ขณะรักษาประโยชน์ของการทบทวนโดยเพื่อนร่วมงาน คือข้อบกพร่องน้อยลง ความรู้ที่แบ่งปัน และร่องรอยการตรวจสอบ พูลรีเควสต์ที่รออยู่ดึงงานที่เสร็จแล้วไว้จากผู้ใช้ เพิ่มต้นทุนของการสลับบริบทของผู้เขียน และทำให้เกิดข้อขัดแย้งในการรวมมากขึ้นเมื่อกิ่งเก่าลง การลดการรอจึงให้ผลตอบแทนผ่านการส่งมอบที่เร็วขึ้น การทำซ้ำที่น้อยลง และความหงุดหงิดที่ลดลง
ต้นทุนของการเก็บตัวชี้วัดเหล่านี้ต่ำเมื่อแพลตฟอร์มควบคุมเวอร์ชันมีประวัติเหตุการณ์และ API ต้นทุนหลักคือเวลานิยามนาฬิกาและรายการยกเว้น สร้างหรือตั้งค่ารายงาน และทบทวนตัวเลขสม่ำเสมอ ต้นทุนที่ใหญ่กว่าคือเชิงพฤติกรรม คือเวลาที่ผู้คนให้กับการทบทวนอย่างทันท่วงที ซึ่งแข่งกับงานอื่น เวลานั้นคือการลงทุนจริงและควรตั้งงบประมาณไม่ใช่ถือว่าฟรี
ผลตอบแทนปรากฏเป็นรอบเวลาการทบทวนที่สั้นลง พูลรีเควสต์ที่ค้างน้อยลง และอัตราการแก้ไขหลังการรวมที่คงที่หรือลดลง หลีกเลี่ยงการอ้างเปอร์เซ็นต์การปรับปรุงเฉพาะเจาะจงล่วงหน้า เพราะผลขึ้นกับจุดเริ่มต้นและทีม กรณีที่น่าเชื่อถือเปรียบเทียบการกระจายก่อนและหลังของทีมเองพร้อมคู่ด้านคุณภาพ แทนการอ้างตัวเลขจากองค์กรอื่น หนังสือ Accelerate ปี 2018 รายงานงานวิจัยที่เชื่อมโยงแนวปฏิบัติด้านเทคนิคและวัฒนธรรมกับผลการดำเนินงานการส่งมอบ และเป็นแหล่งที่สมเหตุสมผลสำหรับข้อโต้แย้งทั่วไป แต่ตัวเลขสำหรับทีมของท่านมาจากข้อมูลของท่านเอง
รูปแบบที่ไม่ควรทำและข้อควรระวัง
- จัดอันดับผู้ทบทวนหรือผู้เขียน ตารางอันดับรายบุคคลของการทบทวนที่ทำเสร็จหรือบรรทัดที่เปลี่ยนทำลายการทำงานร่วมกัน รายงานที่ระดับทีมและใช้ตัวเลขปรับนิสัยของทีม
- ตั้งเป้าหมายเวลาถึงการทบทวนครั้งแรกโดยไม่มีคู่ด้านคุณภาพ ผลคือตรายาง แสดงอัตราการแก้ไขหลังการรวมและตัวอย่างการอนุมัติที่ไม่มีความเห็นข้างแผนภูมิความเร็วทุกอัน
- ตั้งขีดจำกัดขนาดแบบตายตัว ทีมแบ่งงานเทียมเพื่อให้เป็นไปตามกฎ ใช้ขนาดเป็นการสนทนาและสอนเทคนิคการหั่นแทน
- ถือศูนย์ความเห็นเป็นความสำเร็จ การอนุมัติที่ไม่ได้ตรวจอาจสะท้อนความไว้วางใจหรือความไม่ใส่ใจ สุ่มพูลรีเควสต์เหล่านั้นและอ่านร่วมกัน
- นับกิจกรรมของบอตเป็นการทบทวน ความเห็นอัตโนมัติทำให้การรอดูสั้น ไม่นับบอตในนาฬิกาและในการวัดภาระ
- มองข้ามเขตเวลาและปฏิทิน เวลานาฬิกาดิบทำให้การรอข้ามสุดสัปดาห์และข้ามภูมิภาคดูเหมือนการทบทวนช้า ใช้ชั่วโมงทำงานและระบุปฏิทิน
- ปล่อยให้รายการค้างโต พูลรีเควสต์เก่าสะสมข้อขัดแย้งในการรวมและสูญเสียบริบท ทบทวนรายการทุกสัปดาห์และรวม แก้ไขซ้ำ หรือปิดแต่ละรายการพร้อมเหตุผล
แบบจำลองวุฒิภาวะ
| มิติ | 1 เริ่มต้น | 2 พัฒนา | 3 ทำให้เป็นมาตรฐาน | 4 บริหารจัดการ | 5 ประสานจัดการ |
|---|---|---|---|---|---|
| นิยามและนาฬิกา | เดาเวลาทบทวนหรือรายงานตามความรู้สึก | บางทีมส่งออกเวลาจากแพลตฟอร์มด้วยกฎของตนเอง | มีนิยามที่เขียนไว้หนึ่งฉบับของแต่ละนาฬิกา พร้อมรายการยกเว้นสำหรับบอต ฉบับร่าง และปฏิทิน | ทบทวนนิยามตามรอบ บันทึกการเปลี่ยนแปลงพร้อมเหตุผล | นิยามสอดคล้องกันข้ามทีมและผู้ให้บริการ และปรับปรุงเมื่อไม่ช่วยการตัดสินใจอีกต่อไป |
| แนวปฏิบัติการทบทวน | การทบทวนเกิดขึ้นเมื่อมีผู้สังเกตเห็น | บรรทัดฐานไม่เป็นทางการในบางทีม | มีข้อตกลงการทำงานที่เขียนไว้เรื่องคำขอ ความคาดหวังการตอบสนอง และสิ่งที่การทบทวนครอบคลุม | ปรับบรรทัดฐานจากข้อมูล ติดตามการแบ่งปันความรู้และส่วนที่เสี่ยง | ประสานแนวปฏิบัติการทบทวนข้ามทีมและผู้ให้บริการ โดยให้ระบบอัตโนมัติจัดการการตรวจสอบประจำ |
| คู่ด้านคุณภาพ | ไม่มีความเชื่อมโยงระหว่างการทบทวนกับข้อบกพร่อง | ดูการแก้ไขหลังการรวมเป็นครั้งคราว | แสดงอัตราการแก้ไขหลังการรวมข้างความเร็วของการทบทวน | ทบทวนมาตรการป้องกันสม่ำเสมอ อ่านการอนุมัติที่สุ่มตัวอย่าง | เชื่อมหลักฐานการทบทวนกับหลักประกันการเปลี่ยนแปลงและการเรียนรู้จากเหตุขัดข้องข้ามบริการ |
| การใช้ในการปรับปรุง | ไม่ใช้ตัวเลข | แสดงในบางการทบทวนย้อนหลัง | ทีมเจ้าของทบทวนตามรอบที่กำหนด | ช่องว่างนำไปสู่งานปรับปรุงที่วางแผนและมีทรัพยากร | แนวคิดปรับปรุงไหลจากทีมสู่แนวปฏิบัติร่วมและกลับมา |
รายการตรวจสอบ
- เขียนนาฬิกาของเวลาถึงการทบทวนครั้งแรกและรอบเวลาการทบทวน พร้อมจุดเริ่ม จุดหยุด และรายการยกเว้น
- บอต ฉบับร่าง และพูลรีเควสต์ที่ปิดโดยไม่รวมถูกยกเว้นหรือนับแยก และกฎมองเห็นได้
- รายงานเวลาเป็นค่ามัธยฐานและเปอร์เซ็นไทล์สูงเป็นชั่วโมงทำงาน
- วัดขนาดพูลรีเควสต์โดยมีรายการยกเว้นที่ตกลงกันสำหรับไฟล์ที่สร้างอัตโนมัติและโค้ดที่รวมมา
- ทีมมีข้อตกลงที่เขียนไว้ว่าการทบทวนถูกขออย่างไรและคาดหวังการตอบครั้งแรกเร็วเพียงใด
- รายงานการกระจุกตัวของภาระการทบทวนที่ระดับทีมเท่านั้น
- แสดงอัตราการแก้ไขหลังการรวมหรือคู่ด้านคุณภาพอื่นบนแผนภูมิเดียวกับความเร็วของการทบทวน
- อ่านตัวอย่างการอนุมัติที่ไม่มีความเห็นและที่เร็วมากทุกเดือน
- ทบทวนรายการพูลรีเควสต์ที่ค้างทุกสัปดาห์
- ใช้ข้อมูลการทบทวนในการทบทวนย้อนหลังและไม่ใช้ในการประเมินรายบุคคล
- ส่วนของโค้ดที่มีผู้ทบทวนที่มีคุณสมบัติเพียงคนเดียวถูกระบุและมีแผน
พรอมต์ AI
ร่างนิยามนาฬิกาสำหรับตัวชี้วัดการทบทวน
ฉันต้องการนิยามตัวชี้วัดการทบทวนสำหรับ [ทีมหรือคลังโค้ด] แพลตฟอร์มของเราคือ
[แพลตฟอร์มควบคุมเวอร์ชัน] และเวิร์กโฟลว์ของเราคือ [อธิบาย: พูลรีเควสต์ฉบับร่าง
การอนุมัติที่ต้องมี กฎการรวม บอตที่ใช้] ร่างนิยามที่แม่นยำสำหรับเวลา
ถึงการทบทวนครั้งแรกและรอบเวลาการทบทวน โดยระบุเหตุการณ์ที่เริ่มและหยุด
แต่ละนาฬิกา สิ่งที่ไม่นับ (บอต ฉบับร่าง ปิดโดยไม่รวม) วิธีจัดการชั่วโมงทำงาน
สำหรับ [เขตเวลาและปฏิทินการทำงาน] และเปอร์เซ็นไทล์ที่ควรรายงาน อย่าคิดค่าเกณฑ์มาตรฐานหรือคุณสมบัติของเครื่องมือขึ้นเอง ระบุสมมติฐานของคุณและ
คำถามที่ฉันควรตอบเพื่อให้นิยามเสร็จสมบูรณ์
วิเคราะห์ข้อมูลการทบทวนที่ส่งออก
นี่คือข้อมูลที่ส่งออกแบบไม่ระบุตัวตนของพูลรีเควสต์ที่รวมแล้วของ [ทีม] ในช่วง [ช่วงเวลา]
พร้อมคอลัมน์ [รายการคอลัมน์ เช่น เวลาพร้อม เวลาทบทวนครั้งแรก เวลารวม
บรรทัดที่เปลี่ยน รอบการทบทวน ธงการแก้ไขที่เชื่อมโยง]: [วางข้อมูลหรือสรุป] คำนวณ
ค่ามัธยฐานและเปอร์เซ็นไทล์ที่ 85 ของแต่ละการวัดเวลาและขนาด แยกรอบเวลาการทบทวนเป็น
ส่วนรอและส่วนทบทวน และชี้รูปแบบที่สมควรสนทนา อย่าจัดอันดับบุคคล และอย่าเปรียบเทียบกับ
เกณฑ์มาตรฐานภายนอก ระบุสมมติฐานของคุณและปัญหาคุณภาพข้อมูลที่คุณสังเกต
ค้นหาความเสี่ยงของการบิดเบือนในตัวชี้วัดการทบทวนของเรา
ทีมของเรารายงานตัวชี้วัดการทบทวนเหล่านี้: [รายการตัวชี้วัดและวิธีคำนวณแต่ละตัว]
แรงกดดันที่เรามีคือ [เช่น กำหนดการปล่อยรุ่น เป้าหมายจากผู้นำ สัญญา
ผู้ให้บริการ] สำหรับแต่ละตัวชี้วัด อธิบายวิธีที่เป็นไปได้ที่อาจปรับปรุงให้ดีขึ้น
โดยไม่ปรับปรุงการทบทวน สัญญาณแรกเริ่มของแต่ละวิธี และตัวชี้วัดหรือแนวปฏิบัติป้องกัน
ที่จับคู่ซึ่งจะจับได้ อย่าคิดสถิติขึ้นเอง ระบุสมมติฐานของคุณ
และบอกฉันว่าคุณต้องรู้อะไรเพื่อจัดอันดับความเสี่ยง
เตรียมการทบทวนย้อนหลังเรื่องการไหลของการทบทวน
เตรียมวาระการทบทวนย้อนหลัง 45 นาทีสำหรับ [ทีม] เรื่องการไหลของการทบทวน ข้อมูลนำเข้า: เวลา
ถึงการทบทวนครั้งแรก [ค่า] รอบเวลาการทบทวน [ค่า] ค่ามัธยฐานของขนาด [ค่า] การกระจุกตัวของ
ภาระ [ค่า] และอัตราการแก้ไขหลังการรวม [ค่า] โดยติดป้ายนิยามของแต่ละตัว เสนอคำถามที่เผยสาเหตุ การทดลองเล็ก ๆ หนึ่งอย่างที่ทีม
ลองได้เป็นเวลา [ระยะเวลา] และสัญญาณคุณภาพที่ต้องเฝ้าดูระหว่างการทดลอง
อย่าคิดสาเหตุหรือเป้าหมายขึ้นเอง ระบุสมมติฐานของคุณและข้อมูลที่ฉันควรนำมา
ทักษะ AI
- ทักษะ Agile ITIL Metrics: ใช้เพื่อค้นหาหัวข้อที่นิยามตัวชี้วัดการไหลของงานหรือคุณภาพที่เกี่ยวข้อง และมาตรการป้องกันที่ควรอยู่ข้างตัวชี้วัดการทบทวน
- ทักษะผู้ดูแล Agile ITIL Metrics: ใช้เพื่อตรวจสอบว่าการแก้ไขหัวข้อนี้ยังคงแม่แบบ ตารางการบิดเบือน และการอ้างอิงข้ามหัวข้อให้สอดคล้องกัน
ข้อสรุปสำคัญ
- ความล่าช้าของการทบทวนส่วนใหญ่คือการรอ จึงวัดเวลาถึงการทบทวนครั้งแรกและรอบเวลาการทบทวนเป็นการกระจายในชั่วโมงทำงาน
- พูลรีเควสต์ที่เล็กกว่าถูกทบทวนเร็วกว่าและรอบคอบกว่า จึงสอนการหั่นแทนการกำหนดเพดานขนาด
- จับคู่ทุกการวัดความเร็วกับคู่ด้านคุณภาพ เช่น อัตราการแก้ไขหลังการรวม และอ่านทั้งสองร่วมกัน
- ถือภาระการทบทวนเป็นกำลังการทำงานของทีมและรายงานการกระจุกตัวที่ระดับทีม ไม่เคยเป็นการจัดอันดับคน
- ตัวชี้วัดการทบทวนเป็นคำถามสำหรับการทบทวนย้อนหลัง และรับใช้ทีมที่เป็นเจ้าของงาน
เอกสารอ้างอิงและแหล่งอ่านเพิ่มเติม
- Forsgren, N., Humble, J., and Kim, G., Accelerate: The Science of Lean Software and DevOps, IT Revolution, 2018.
- Forsgren, N., Storey, M.-A., Maddila, C., Zimmermann, T., Houck, B., and Butler, J., "The SPACE of Developer Productivity," ACM Queue, 2021.
- Google, Code Review Developer Guide, Google Engineering Practices documentation, https://google.github.io/eng-practices/review/
- Bacchelli, A., and Bird, C., "Expectations, Outcomes, and Challenges of Modern Code Review," Proceedings of the 35th International Conference on Software Engineering (ICSE), 2013.
- Vacanti, D. S., Actionable Agile Metrics for Predictability: An Introduction, Daniel S. Vacanti, Inc., 2015.
- Schwaber, K., and Sutherland, J., The Scrum Guide, Scrum.org and Scrum Inc., 2020.
- Goodhart, C. A. E., "Problems of Monetary Management: The U.K. Experience," in Papers in Monetary Economics, Reserve Bank of Australia, 1975.
- Wikipedia, Pull request.
- Wikipedia, Version control.
- Wikipedia, Code review.
- Wikipedia, Goodhart's law.
- Wikipedia, Continuous integration.
- Wikipedia, Trunk-based development.
- Wikipedia, Pair programming.
- Wikipedia, Static program analysis.