การเลือกเมตริกที่เหมาะกับโปรเจ็กต์ของคุณ

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

ระยะปัจจุบัน:
ประกาศผล ไทม์ไลน์

ระบุปัญหาของคุณ

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

  • "การดึงคำขอสำหรับเอกสารประกอบการเริ่มต้นใช้งานใช้เวลานานเกินไปในการผสาน ผู้ให้การสนับสนุนก็ยอมแพ้แล้วก็หายไป"
  • "เราพบปัญหามากเกินไปในการช่วยทำความเข้าใจรหัสข้อผิดพลาด"
  • "ไปป์ไลน์ CI/CD ของเรามีความซับซ้อน มีการทดสอบที่ล้มเหลวหลายครั้งเกินไปด้วยเหตุผลที่ไม่เข้าใจ"
  • "การประชุมรายสัปดาห์ของเรามีคนหน้าบึ้งตื้น"

พัฒนาสมมติฐาน

มองหาเหตุและผล ปัญหาที่คุณระบุไว้อาจเกิดจากอะไร โปรดทราบว่าปัญหาอาจมีสาเหตุหลายสาเหตุหรือทับซ้อนกัน

  • "การผสานรวมคำขอแบบพุลสำหรับเอกสารประกอบการเริ่มต้นใช้งานใช้เวลานานมาก เพราะเราไม่มีคำแนะนำที่ชัดเจนเกี่ยวกับสไตล์ ผู้ตรวจสอบอาจเลื่อนการตรวจสอบการประชาสัมพันธ์ออกไปเนื่องจากไม่ทราบว่าต้องทำอย่างไร หรือกลับไปกลับมาหาผู้ให้ข้อมูลร่วมกันเกี่ยวกับการจัดรูปแบบ"
  • "ผู้ใช้ต้องเปิดปัญหาเพราะไม่พบข้อมูลเกี่ยวกับรหัสข้อผิดพลาดในเอกสาร"
  • "การทดสอบ CI/CD ล้มเหลวเนื่องจากพบข้อจำกัดและระยะหมดเวลาของแผนจากผู้ให้บริการ"
  • "ทุกคนหน้าบึ้งในการประชุมรายสัปดาห์ของเราเพราะเวลาประชุมตอน 5:30 น. ตามเขตเวลาของพวกเขา"

เสนอวิธีแก้ปัญหา

ปัญหานี้ที่แก้ไขได้ด้วยเอกสารประกอบใหม่หรือที่ดีกว่าเดิมใช่ไหม

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

ระบุรายละเอียดที่เฉพาะเจาะจง

ช่วยวัดปริมาณปัญหาได้ไหม

  • "การที่จะรวม PR นั้นใช้เวลานานเกินไป" หมายความว่าอะไร แล้วถ้าสองเดือนล่ะ หลังผ่านไป 2 สัปดาห์ใช่ไหม ผู้ร่วมให้ข้อมูลจะรอตรวจสอบนานเท่าใดก่อนที่จะสละสิทธิ”
  • "ปัญหาที่เกี่ยวข้องกับรหัสข้อผิดพลาดมีกี่ข้อที่เป็น 'ปัญหามากเกินไป'"
  • "อืม... หน้าตาบึ้งแค่ไหน 'หน้าบึ้งเกินไป' นั่นแหละ"

ตรวจสอบความสามารถในการวัด

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

  • "เราสามารถวัดได้โดยง่ายว่าเปิดคำขอพุลมานานเท่าใดแล้ว และนับตั้งแต่ขอรับการตรวจสอบ เราไม่สามารถวัดได้ชัดเจนว่า ผู้ให้การสนับสนุนจะเลิกเป็นผู้สนับสนุนเมื่อใด"
  • “เราสามารถนับจำนวนปัญหาที่มีการติดแท็ก ‘รหัสข้อผิดพลาด’ หรือค้นหาข้อความของรหัสข้อผิดพลาดในปัญหา”
  • "เราวัดความขุ่นเคืองของผู้คนไม่ได้ด้วยวิธีที่แม่นยำหรือจริงจังไม่ได้"

เพิ่มเมตริกรอง

มีเมตริกอื่นๆ ที่จะช่วยให้คุณเข้าใจว่าเอกสารช่วยแก้ปัญหาได้ไหม เมตริกเป้าหมายของคุณเหมือนกันทุกกรณีไหม

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

เลือกระยะเวลา

  • "เราคิดว่า 2 สัปดาห์เป็นเวลาที่เหมาะสมในการรวม PR ขนาดเล็กถึงขนาดกลาง เข้าด้วยกัน และ PR ทั้งหมดควรรวมกันภายใน 1 เดือน เราจะวัดผลทุกๆ 2 สัปดาห์"
  • "เราไม่ควรอัปเดตจำนวนปัญหาที่เกี่ยวข้องกับรหัสข้อผิดพลาดทุกวัน เพราะเวลาทั่วไปในการปิดปัญหาคือ 1 สัปดาห์ เราจะวัดผลทุกสัปดาห์"

ตั้งเป้าหมาย

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

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