เอกสารประกอบเป็นเรื่องราวของผู้ใช้หรือไม่ [ปิด]


13

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

ฉันแค่สงสัยความคิดเห็นของคุณเกี่ยวกับวิธีการนี้ โดยส่วนตัวฉันไม่เห็นด้วยว่าเอกสารเป็นเรื่องราวของผู้ใช้ภายในการต่อสู้เพราะมันไม่ได้สร้างรหัสใด ๆ

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


คุณสงสัยเกี่ยวกับการสร้างเรื่องราวของผู้ใช้เพื่อสร้างเอกสารระบบหรือใช้เรื่องราวของผู้ใช้เป็นเอกสารของระบบหรือไม่
Ryathal

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

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

1
@JeffO - ฉันค่อนข้างจะเขียนโค้ดขอบคุณ บางทีฉันสามารถเขียนรหัสเพื่อเขียนเอกสาร ... เรียงลำดับของเครื่อง Light Von Neumann: p
SoylentGray

คำตอบ:


15

"ในฐานะผู้ใช้ X ฉันต้องรู้ว่า X ทำงานอย่างไร" ดูเหมือนจะเป็นเรื่องราวของผู้ใช้ที่ถูกกฎหมายสำหรับฉัน ซึ่งอาจส่งผลในเอกสารเป็นลายลักษณ์อักษรหรือความช่วยเหลือออนไลน์

จุดนี้ไม่ได้เป็นเพียงรหัส แต่เป็นไปตามข้อกำหนดของผู้ใช้


6
ผู้ประกอบการผู้ดูแลระบบและผู้ใช้ด้านเทคนิคอื่น ๆ คือผู้ใช้ชั้นหนึ่ง พวกเขาได้รับเรื่องราวของผู้ใช้เช่นเดียวกับผู้ใช้ทุกคน
S.Lott

10

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

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

ถ้านี่หมายความว่ามันไม่เคยทำมาก่อนเพราะสิ่งนี้และฟังก์ชั่นนั้นกำลังใช้งานอยู่คุณอาจไม่ต้องการเอกสารที่ไม่ดี


3
หากจำเป็นต้องใช้เอกสารในที่สุดก็สามารถเป็นส่วนหนึ่งของคำนิยามของการทำ
Hugo

3

ฉันเห็นด้วยกับการประเมินเอกสารของ pdr หากเกี่ยวกับข้อกำหนดทางเทคนิคหรือเอกสารประกอบของโครงการ เป็นการดีที่มันควรจะรวมอยู่ในงานวิ่ง

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

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


1

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

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

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

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

โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.