ฉันเชื่อว่ามีเอกสารใด ๆ ที่แนวทางความคล่องตัวเป็นสิ่งที่ดี ขณะนี้มีความเข้าใจที่คลาดเคลื่อนอยู่บ้างนั่นคือความคล่องตัวหมายถึง "ไม่มีเอกสารหรือการวิเคราะห์เลย" แต่นั่นไม่ใช่กรณี สิ่งที่ฉันได้อ่านเกี่ยวกับเปรียวพูดว่า "ใช้สิ่งที่ทำงาน" ฉันหมายถึงว่าเอกสารควรมีความยาวและรายละเอียดตรงกับงาน
เทมเพลตมีประโยชน์ในฐานะรายการตรวจสอบ แต่ฉันไม่ต้องการให้กรอกทุกส่วนสำหรับการเปลี่ยนแปลงเล็ก ๆ หรือความเสี่ยงต่ำ สำหรับการเปลี่ยนแปลงหนึ่งบรรทัดคุณอาจไม่ต้องการเอกสารเลย ฉันไม่เคยใช้เทมเพลตสำหรับเอกสารการวิเคราะห์ผลกระทบ แต่ฉันจัดการกับข้อกำหนดทางธุรกิจหรือข้อกำหนดทางเทคนิคเป็นประจำ แม่แบบอาจเข้มงวดเกินไป แนวทางที่ดีแทนที่จะพิจารณาว่าใครจะเป็นผู้ชม หากเป็นสำหรับผู้จัดการที่ไม่ใช่ด้านเทคนิคให้เน้นที่เหตุผลทางธุรกิจสำหรับการเปลี่ยนแปลง หากเป็นเรื่องของบุคลากรด้านเทคนิคให้ภูมิหลังเล็กน้อยเพื่อให้คนใหม่ในทีมจะไม่สูญหายและให้พวกเขาเพียงพอที่จะไปหากพวกเขาต้องสนับสนุนการเปลี่ยนแปลง นอกจากนี้หากคุณต้องการบางสิ่งบางอย่างที่ยิ่งเสียดทานน้อยกว่าและมีน้ำหนักเบาไม่ต้องใช้เอกสารเลยให้วางไว้บนวิกิ
ข้อมูลที่จะรวมถึง:
- คำอธิบายสั้น ๆ ของปัญหา
- อธิบายหรือแสดงตัวอย่างว่าข้อบกพร่องทำให้เกิดความล้มเหลวและ / หรือไร้ประสิทธิภาพอย่างไร
- รวมการประมาณความซับซ้อน
- รวมการประมาณการต้นทุนและเวลาสำหรับการแก้ไข
นั่นเป็นขั้นต่ำที่เหมาะสม โพสต์อื่นเน้นบางสิ่งที่ CMMi ค่อนข้างหนักจาก IBM; มันยอดเยี่ยมมากถ้าคุณมีเวลาและทรัพยากรสำหรับมัน (และเมื่อคุณสร้างระบบสำหรับ NASA ที่ชีวิตมนุษย์ตกอยู่ในความเสี่ยงคนส่วนใหญ่จะจริงจังกับมัน) แต่สำหรับทีมเล็ก ๆ คุณอาจไม่จำเป็นต้องหนักขนาดนั้น . ระมัดระวังกับการประมาณการเช่นเคย ผู้จัดการมีแนวโน้มที่จะสมมติว่าการประมาณการเป็นจริง
โปรดทราบว่ามีอันตรายในแนวทางที่คล่องตัว นักพัฒนาบางคนคิดว่ามันหมายความว่า "ไม่ต้องการเอกสารเพียงแค่เริ่มแฮ็ค" (ซึ่งอาจจะใช้ได้ในบางสถานการณ์) นอกจากนี้คนอื่น ๆ จะใช้ละติจูดตามที่ได้รับมอบหมายและเพียงแค่เขียนเอกสารเส็งเคร็งจริงๆที่ไม่ได้ช่วยอะไรเลย (ไม่จำเป็นว่าจะต้องตกลงในสถานการณ์ส่วนใหญ่) ส่วนหนึ่งของปัญหาคือการเขียนที่ดีต้องใช้ความพยายามทักษะและเวลา ส่วนใหญ่ของเราสั้น ๆ อย่างน้อยสองสิ่งนั้น)
ฉันมักจะเอกสารขนาดใหญ่เพราะมันพิสูจน์ให้คุณอย่างน้อยก็คิดว่าเพียงพอที่จะมีคุณสมบัติเป็นแผน แต่ในวัยชราของฉันฉันเองก็รู้สึกยินดีที่เอกสารมากเกินไปอาจกลายเป็นปัญหาในการบำรุงรักษาและคนไม่พอที่จะดูแลเอกสารให้ทันสมัยอยู่เสมอ