พื้นฐาน: การอ่านบันทึกการตรวจสอบของงานสร้าง

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

มันอยู่ตรงการ์ดเวอร์ชันเลย ข้างๆ ตัวอย่างและปุ่มจัดการโค้ด — ที่เดียวกับที่คุณจะไปเพื่อดีพลอยใหม่หรือย้อนกลับเวอร์ชัน สิ่งแรกที่ฉันสังเกตคือ มันจำกัดขอบเขตอยู่ที่เวอร์ชันนั้นเวอร์ชันเดียว ไม่ใช่ทั้งบทสนทนา ฉันทำการวนแก้ไขงานนี้ห้ารอบเพื่อไล่จับปัญหาตัวเลือกวันที่ที่พัง และเกือบจะคาดหวังว่าบันทึกจะเล่าเรื่องราวทั้งหมดของการไปมา แต่ไม่ใช่ บันทึกของเวอร์ชัน 4 อธิบายแค่เวอร์ชัน 4 มันไม่มีความจำว่าเวอร์ชัน 2 เคยส่งมอบพร้อมฟอร์มล็อกอินที่พังแบบเงียบๆ และจะไม่บอกฉันว่าเวอร์ชัน 5 แอบแก้สิ่งที่เวอร์ชัน 3 ทำพัง แต่ละบันทึกเป็นภาพนิ่ง ไม่ใช่ diff และไม่ใช่ changelog — ถ้าฉันต้องการประวัติว่าอะไรเปลี่ยนไปในแต่ละรุ่น นั่นเป็นมุมมองอีกแบบไปเลย บันทึกนี้ตอบแค่คำถามว่า "เวอร์ชันนี้ใช้ได้หรือไม่"

เลื่อนลงไป บันทึกจะแบ่งออกเป็นหกแถว:

ทั้งหกแถวเป็นสีเขียวหมด และสัญชาตญาณแรกของฉันคือสัญชาตญาณที่ผิดแบบเดียวกับที่คนส่วนใหญ่คงมี: ความปลอดภัยผ่าน แปลว่าปลอดภัย, การเข้าถึงผ่าน แปลว่าเข้าถึงได้ ทั้งสองการตีความนี้ไม่รอดเมื่อเทียบกับสิ่งที่การตรวจสอบทำจริงๆ การผ่านด้านความปลอดภัยหมายถึงสิ่งที่เห็นได้บนพื้นผิว — การต่อสตริงเข้าไปในคิวรี คีย์ API ที่หลุดอยู่ในบันเดิลฝั่งไคลเอนต์ eval บนสิ่งที่ผู้ใช้พิมพ์ — ไม่ปรากฏขึ้นมา มันไม่ใช่วันที่มีนักทดสอบเจาะระบบมาตรวจ วิดเจ็ตของสตูดิโอเพื่อนฉันไม่ได้รับเงินผ่านช่องนี้ แค่รับชื่อและเวลานัด ดังนั้นระดับพื้นฐานนี้ก็เพียงพอสำหรับเธอ ถ้าเป็นระบบชำระเงิน ฉันคงต้องการมากกว่าแค่ระดับพื้นฐาน

การเข้าถึงเป็นแถวที่ทำให้ฉันต้องหยุดและค้นหาข้อมูลเพิ่ม เพราะคำว่า "axe pass" ฟังดูครอบคลุมทุกอย่างแต่ไม่ใช่ Axe — เอนจินอัตโนมัติที่ทำงานอยู่เบื้องหลัง — จับได้เพียงประมาณหนึ่งในสามถึงครึ่งหนึ่งของเกณฑ์ความสำเร็จ WCAG อย่างสม่ำเสมอ: alt text ที่หายไป อัตราส่วนคอนทราสต์ที่แย่ ฟิลด์ฟอร์มที่ไม่มีป้ายกำกับ การใช้ ARIA ที่ผิดอย่างชัดเจน มันบอกไม่ได้ว่าดรอปดาวน์เลือกวันที่แบบกำหนดเองที่ฉันขอไปนั้นใช้งานได้กับโปรแกรมอ่านหน้าจอหรือไม่ การกดแท็บผ่านขั้นตอนการจองหลายขั้นทำให้โฟกัสตกไปในตำแหน่งที่สมเหตุสมผลหรือไม่ หรือสถานะ "ยืนยันแล้ว" กับ "รอดำเนินการ" ที่ฉันใช้สีเขียวกับเหลืองจะเป็นปัญหาสำหรับคนที่ตาบอดสีแดง-เขียวหรือไม่ สิ่งเหล่านี้ต้องอาศัยคนตรวจสอบงานโดยปิดเครื่องมือช่วยเหลือที่ผู้ใช้ที่มีความบกพร่องพึ่งพาจริงๆ Axe คือสัญญาณที่มีค่าจริง ไม่ใช่ไร้ประโยชน์ — มันเป็นชั้นตรวจตัวสะกดของงานด้านการเข้าถึง ไม่ใช่บรรณาธิการ

ความสอดคล้อง (Conformance) เป็นแถวที่ฉันเกือบข้ามผ่านไป เพราะฟังดูเป็นทางการเกินไป — "มีสิ่งที่แผนสัญญาไว้" — จนกระทั่งฉันนึกขึ้นได้ว่าแผนที่ฉันอนุมัติไปนั้นเขียนขึ้นตอนที่ฉันไม่ได้ตั้งใจ และจำไม่ได้จริงๆ ว่าขอให้มีอีเมลยืนยันหรือแค่ SMS ชั้นนี้คือชั้นที่ตรวจสอบงานที่สร้างเทียบกับแผน ไม่ใช่เทียบกับความตั้งใจจริงของฉัน และมันผ่าน ซึ่งบอกฉันว่างานตรงกับสิ่งที่ฉันตอบตกลงไป ไม่จำเป็นว่าตรงกับสิ่งที่ฉันหมายถึงจริงๆ ฉันเคยได้ยินเรื่องงานที่ทำงานได้ดีและปลอดภัยแต่ยังคงตกในชั้นนี้เพราะฟีเจอร์หนึ่งถูกตัดออกไปอย่างเงียบๆ ภายใต้แรงกดดันด้านเวลา นี่คือชั้นที่รักษาความซื่อสัตย์ของงานต่อบทสนทนาที่ก่อให้เกิดมันขึ้นมา แม้ว่าบทสนทนานั้นเองจะไม่ค่อยเรียบร้อยนักก็ตาม

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

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

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

อีกสิ่งที่ฉันบังคับตัวเองให้ทำ เนื่องจากบันทึกนี้เก่าไปแล้วสามสัปดาห์ คือตรวจสอบว่าชั้นใดทำงานจริงก่อนที่จะเชื่อผลตัดสินเลย ทั้งหกชั้นปรากฏอยู่ในบันทึกนี้ แต่ฉันเคยเห็นงานที่ชั้นการเข้าถึงหายไปจากรายการเฉยๆ แทนที่จะถูกทำเครื่องหมายว่าผ่านหรือไม่ผ่าน — นั่นไม่เหมือนกับการถูกข้ามเพราะไม่สำคัญ มันเป็นสัญญาณว่าการตรวจสอบนั้นไม่ได้ทำงานสำหรับประเภทเว็บไซต์หรือการตั้งค่าแฟล็กนั้นๆ และการอ่านการหายไปว่าเป็นการผ่านแบบเงียบๆ คือความผิดพลาดที่รูปแบบนี้เชื้อเชิญให้เกิดขึ้นได้พอดี ถ้าคุณแค่อ่านผ่านๆ

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