คู่มือนี้จัดทำขึ้นเพื่อช่วยให้องค์กรต่างๆ เข้าใจว่าปัญหาประเภทใดที่อาจแก้ไขได้ด้วยเอกสารประกอบที่ดีขึ้น และวิธีเลือกเมตริกที่เหมาะสมสำหรับโครงการเอกสารประกอบ
ระยะปัจจุบัน:
ประกาศผล ดูไทม์ไลน์
ระบุปัญหาของคุณ
ก่อนที่จะไปเลือกเมตริก คุณควรทำความเข้าใจปัญหาที่กำลังพยายามแก้ให้ดี โปรดระบุให้เฉพาะเจาะจงที่สุด
- "คำขอการดึงสำหรับเอกสารประกอบการเริ่มต้นใช้งานของเราใช้เวลานานเกินไปในการผสานรวม ผู้มีส่วนร่วมก็ยอมแพ้และจากไป"
- "เราพบปัญหามากเกินไปในการช่วยเข้าใจรหัสข้อผิดพลาด"
- "ไปป์ไลน์ CI/CD ของเราไม่สม่ำเสมอ การทดสอบล้มเหลวหลายครั้งเกินไปด้วยเหตุผลที่ไม่เข้าใจ"
- "การประชุมรายสัปดาห์ของเรามีคนหน้าบึ้งตึง"
สร้างสมมติฐาน
มองหาสาเหตุและผลกระทบ ปัญหาที่คุณระบุไว้อาจเกิดจากอะไร โปรดทราบว่าปัญหาอาจมีหลายสาเหตุหรือหลายสาเหตุที่ทับซ้อนกัน
- "การรวมคำขอพุลนั้นใช้เวลานานมากในเอกสารประกอบการเริ่มต้นใช้งานเนื่องจากเราไม่มีคำแนะนำที่ชัดเจนเกี่ยวกับสไตล์ ผู้ตรวจสอบอาจเลื่อนการตรวจสอบการประชาสัมพันธ์เนื่องจากไม่ทราบว่าต้องทำอย่างไร หรือกลับไปกลับมาหาผู้ให้ข้อมูลร่วมกันเกี่ยวกับการจัดรูปแบบ"
- "ผู้ใช้ต้องเปิดปัญหาเพราะไม่พบข้อมูลเกี่ยวกับรหัสข้อผิดพลาดในเอกสาร"
- "การทดสอบ CI/CD ล้มเหลวเนื่องจากพบข้อจำกัดของแผนและระยะหมดเวลาจากผู้ให้บริการ"
- "ผู้คนหน้าบึ้งในการประชุมรายสัปดาห์ของเรา เพราะการประชุมจัดขึ้นในเวลา 5:30 น. ตามเขตเวลาของพวกเขา"
เสนอโซลูชัน
ปัญหานี้ที่แก้ไขได้ด้วยเอกสารประกอบใหม่หรือดีกว่าหรือไม่
- "หากเรามีคู่มือแนะนำสไตล์ คณะกรรมการจะดูได้ก่อนที่จะส่ง PR ผู้ตรวจสอบทราบว่าควรตรวจสอบสิ่งใด นักรีวิวและผู้มีส่วนร่วมจะได้ไม่ต้องถกเถียงเรื่องการจัดรูปแบบ โทน และสไตล์"
- "หากเรามีเอกสารเกี่ยวกับรหัสข้อผิดพลาด ผู้ใช้จะค้นหาคำตอบได้ที่นั่น แทนที่จะต้องเปิดประเด็นปัญหา"
- "อืม ดูเหมือนว่าเอกสารประกอบที่จะแก้ปัญหา CI/CD ของเราไม่ได้ดีไปกว่านี้"
- "เราเริ่มการประชุมแต่ละครั้งได้ด้วยมุกตลกน็อกเอาต์ การสร้างคอลเล็กชันมุกตลกเคาะประตูมักช่วยให้เราเริ่มต้นการประชุมได้ด้วยรอยยิ้ม"
ระบุรายละเอียดที่เฉพาะเจาะจง
คุณช่วยวัดปริมาณปัญหาได้ไหม
- "การที่ 'การรวม PR เข้าด้วยกันใช้เวลานานเกินไป' นั้นหมายถึงอะไร แล้วถ้า 2 เดือน 2 สัปดาห์ ผู้ร่วมให้ข้อมูลจะรอตรวจสอบนานเท่าใดก่อนที่จะสละสิทธิ์"
- "ปัญหาที่เกี่ยวข้องกับรหัสข้อผิดพลาดมีกี่ปัญหาที่เป็น 'จำนวนปัญหามากเกินไป'"
- "อืมม ... หน้าบึ้งนี่มันหน้าบึ้งแค่ไหน"
ตรวจสอบความสามารถในการวัด
คุณจะตรวจสอบเมตริกที่เสนออย่างไร วัดผลได้ง่ายและแม่นยำไหม การวัดขึ้นอยู่กับผู้ที่วัดผลหรือไม่
- "เราสามารถวัดได้โดยง่ายว่าคำขอดึงข้อมูลเปิดไว้นานเท่าใดและนับตั้งแต่มีการขอรับการตรวจสอบ เราไม่สามารถวัดผลได้แน่ชัดว่า ผู้ร่วมให้ข้อมูลจะเลิกให้ความสนใจเมื่อใด"
- "เราสามารถนับจำนวนปัญหาที่มีการติดแท็ก "รหัสข้อผิดพลาด" หรือการค้นหาภายในปัญหาสำหรับข้อความรหัสข้อผิดพลาด"
- "เราวัดความไม่สบายใจของผู้คนด้วยวิธีที่แม่นยำหรือแม่นยำไม่ได้"
เพิ่มเมตริกรอง
มีเมตริกอื่นๆ ที่จะช่วยให้คุณเข้าใจว่าเอกสารช่วยแก้ปัญหาไหม เมตริกเป้าหมายของคุณเหมือนกันในทุกกรณีไหม
- "ผู้จัดการฝ่าย PR ที่ยาวกว่าจะใช้เวลาตรวจสอบนานกว่า เราควรมีเกณฑ์ที่แตกต่างกันสำหรับ PR ขนาดต่างๆ เราต้องการวัดเวลาในการผสานรวมสำหรับ PR ขนาดเล็ก กลาง ใหญ่ และขนาดใหญ่"
- "เราสามารถตรวจสอบจำนวนการเข้าชมที่เอกสารเกี่ยวกับรหัสข้อผิดพลาดของเราได้รับ และดูว่าจำนวนนั้นเกี่ยวข้องกับปัญหาที่น้อยลงหรือไม่"
เลือกระยะเวลา
- "เราคิดว่า 2 สัปดาห์เป็นเวลาที่เหมาะสมในการรวม PR ขนาดเล็กถึงขนาดกลาง เข้าด้วยกัน โดยการรวม PR ทั้งหมดควรรวมกันภายใน 1 เดือน ดังนั้นเราจะวัดผลทุก 2 สัปดาห์"
- "เราไม่ควรอัปเดตจำนวนปัญหาที่เกี่ยวข้องกับรหัสข้อผิดพลาดทุกวัน เพราะเวลาโดยทั่วไปของเราในการปิดปัญหาคือ 1 สัปดาห์ เราจะวัดผลทุกสัปดาห์"
ตั้งเป้าหมาย
คุณต้องเห็นความเปลี่ยนแปลงมากน้อยเพียงใดในเมตริกที่เลือกเพื่อบอกว่าโครงการประสบความสำเร็จ ลองตั้งเป้าหมายเชิงปริมาณสำหรับเมตริกที่คุณเลือก
- "ถ้าเราบรรลุเป้าหมายในการปิดการขายใหม่ทุกครั้งในเวลาไม่ถึง 1 เดือน เราจะถือว่าประสบความสำเร็จ หากเวลาเฉลี่ยในการปิดการขายจำนวนมากของเราลดลงถึง 2 สัปดาห์ นั่นก็จะประสบความสำเร็จอย่างล้นหลาม"
- "เราน่าจะไม่พบปัญหาใหม่ๆ ที่เกี่ยวข้องกับข้อผิดพลาด แต่เราจะถือว่าโครงการของเราประสบความสำเร็จหากพบว่าปัญหาที่เกี่ยวข้องกับข้อผิดพลาดลดลงถึง 50%"
ข้อมูลที่เกี่ยวข้อง
- อ่านคู่มือผู้ดูแลระบบองค์กรเพื่อรับความช่วยเหลือเกี่ยวกับงานที่เกี่ยวข้องกับรายงาน