ใครเขียน ADR ได้บ้าง

พิจารณาด้านต่าง ๆ เช่น บุคคลเฉพาะ บทบาทเฉพาะ ทีมเฉพาะ แผนกเฉพาะ และพิจารณาด้วยว่ามีบุคคล บทบาท ทีม หรือแผนกที่สามารถว่าจ้างให้เขียน ADR ได้หรือไม่ กล่าวคือขอให้คนอื่นเขียน ADR ได้

ตัวอย่างคำตอบ: ทุกคนในองค์กรของเราที่ได้อ่านหน้า README เกี่ยวกับบันทึกการตัดสินใจด้านสถาปัตยกรรมสามารถเสนอ ADR ได้ กล่าวคือเริ่มเขียนและแชร์กับทีม

อะไรเป็นเหตุผลให้เปิด ADR

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

ตัวอย่างคำตอบ: เราต้องการเขียน ADR เมื่อเราต้องการให้นักพัฒนาในอนาคตเข้าใจ "ทำไม" ของสิ่งที่เราทำ

อะไรที่ไม่เป็นเหตุผลให้เปิด ADR

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

ตัวอย่างคำตอบ: เราต้องการข้าม ADR เมื่อการตัดสินใจจำกัดในขอบเขต เวลา ความเสี่ยง และต้นทุน หรือมีการครอบคลุมที่อื่นแล้ว

วงจรชีวิตของ ADR คืออะไร

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

ตัวอย่างคำตอบ: เราต้องการให้ ADR มีห้าขั้นตอนของวงจรชีวิต: Initiating → Researching → Evaluating → Implementing → Maintaining → Sunsetting

เกณฑ์สำหรับขั้นตอนวงจรชีวิตของ ADR คืออะไร

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

ตัวอย่างคำตอบ: เราต้องการให้ทีมที่ทำงานอยู่ 1) ค้นคว้าให้เสร็จ 2) ประเมินให้เสร็จ 3) เผยแพร่ข้อเสนอ ADR ให้ผู้มีส่วนได้ส่วนเสียพร้อมคำขอความเห็นและกรอบเวลาหนึ่งสัปดาห์ และ 4) เมื่อความเห็นของผู้มีส่วนได้ส่วนเสียทั้งหมดได้รับการนำมาปรับใช้และจัดการแล้ว ให้ผู้มีส่วนได้ส่วนเสียลงคะแนนเกี่ยวกับ ADR

บทบาทและความรับผิดชอบใดที่เกี่ยวข้องกับ ADR

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

ตัวอย่างคำตอบ: เราต้องการให้ทุก ADR มีเจ้าของหลัก เจ้าของรอง และทีมที่รับผิดชอบเสมอ พวกเขารับผิดชอบการสื่อสาร การเผยแพร่ การบำรุงรักษา การทบทวนเป็นระยะอย่างน้อยปีละครั้ง และการยุติการใช้งานในท้ายที่สุดเมื่อจำเป็น

ธรรมาภิบาลเกี่ยวข้องกับ ADR อย่างไร

พิจารณาด้านต่าง ๆ เช่น วิธีที่องค์กรทำงาน ความต้องการด้านการปฏิบัติตามกฎระเบียบเป็นพิเศษ เช่น แง่มุมทางกฎหมายหรือทรัพยากรบุคคล และวิธีที่คุณต้องการจัดการฉันทามติเทียบกับความขัดแย้งเทียบกับการยกระดับ มีด้าน บุคคล หรือทีมใดที่อาจมีอิทธิพลมากกว่าผู้อื่นหรือไม่ เช่น อำนาจในการอนุมัติ ลงคะแนน หรือยับยั้งที่เกี่ยวกับ ADR

ตัวอย่างคำตอบ: ธรรมาภิบาลของ ADR เป็นไปตามลำดับความสำคัญนี้: CEO, CTO, CLO, ทีมที่นำ ADR ไปใช้, ผู้เชี่ยวชาญที่รู้มากที่สุดในทีมเกี่ยวกับ ADD ไม่มีใครมีธรรมาภิบาล เว้นแต่อธิบายไว้ใน ADR

หลักการใดที่เกี่ยวข้องกับ ADR

พิจารณาด้านที่เกี่ยวข้องกับวิธีที่องค์กรทำงาน เช่น การเคลื่อนไหวเร็วหรือช้า ฉันทามติของการตัดสินใจเทียบกับความขัดแย้งของการตัดสินใจ ความชอบเสี่ยงเทียบกับความชอบปลอดภัย และการอภิปรายสาธารณะเทียบกับการอภิปรายส่วนตัว

ตัวอย่างคำตอบ: เราใช้หลักการความเป็นผู้นำ ได้แก่ มุ่งเน้นการลงมือทำ (bias for action) เห็นต่างแต่ยึดมั่นร่วมกัน (disagree-and-commit) ข้อมูล 70% เพียงพอสำหรับการตัดสินใจที่ย้อนกลับได้ง่ายและแยกออกได้ง่าย และการทำงานอย่างเปิดเผย ยกเว้นข้อมูลที่เป็นความลับตามที่อธิบายไว้ในข้อตกลงรักษาความลับขององค์กรของเรา