If you’re clear and precise, you’ll

If you’re clear and precise, you’ll probably get what you want. If there is any
problem when the thing is done, you have a record of what you asked for and
a credible basis for requesting corrections or improvements.
When you want something complicated, you must write a more detailed
requirements document. And when you’re explaining not only your own needs,
but also the needs of a group, you must find a way to include the group of
needers in your process and systematically find out what they want. (God
didn’t have this issue. He knew what he wanted in an ark and didn’t have to
reach consensus.) Once you’ve written something, you have to check back
with the needers to make sure you are correctly expressing their needs. If
the needers can’t make sense of what you’ve written, they can’t tell you if you
got it right.
Just as God does with Noah, we do better if we explain what we want in
plain language and a clear and logical sequence. We do better when we tell
a story.
This book explains how to write a software requirements document using
storytelling, the most ancient and human means for sharing information. I
know you can’t make a software requirements document into a story as excit‑
ing as Noah’s Ark or Huckleberry Finn. But you can make a narrative that is
engaging and easy to follow for the people who have an interest in solving
the problem at hand. In the narrative, the problem should be clearly stated
at the beginning, and all points should lead to the solution, with each point
following from one to the next in a logical sequence of dependent outcomes.
It also helps if you use a lot of pictures.
When you need something pretty ordinary that people have been making
for a long time, like a chair or a hamburger, you don’t usually have to explain
what you want in much detail. There are perhaps a few variables you need to
specify (with cheese, no fries, medium rare). It’s more challenging when you
need something complicated and specialized such as a new software system.
Only very skilled and specialized engineers make software, and they have
gone to special schools to learn new languages and tools (Java, C#, and so
on). These engineers mostly communicate with each other about what they
make, using all the special words from these new languages, and pretty soon
ordinary people can’t understand them very well.
The challenge when trying to write a story about what you want software
to do is to make it understandable to two groups that communicate in very
different ways: the needers of the software and engineers who make it. If both
groups do not understand and approve of your story, it will fail.

ผลลัพธ์ (ไทย) 1:

ถ้าคุณเป็นที่ชัดเจนและแม่นยำคุณอาจจะได้รับสิ่งที่คุณต้องการ หากมีปัญหาใด ๆ
เมื่อสิ่งที่จะทำคุณมีบันทึกของสิ่งที่คุณขอและ
พื้นฐานความน่าเชื่อถือสำหรับการแก้ไขหรือขอปรับปรุง
เมื่อคุณต้องการสิ่งที่ซับซ้อนคุณต้องเขียนรายละเอียดเพิ่มเติม
เอกสารความต้องการ และเมื่อคุณกำลังอธิบายไม่เพียง แต่ตอบสนองความต้องการของคุณเอง
แต่ยังตอบสนองความต้องการของกลุ่มที่คุณจะต้องหาวิธีที่จะรวมกลุ่มของ
needers ในกระบวนการของคุณและเป็นระบบหาสิ่งที่พวกเขาต้องการ (พระเจ้า
ไม่ได้มีปัญหานี้. เขารู้ว่าสิ่งที่เขาต้องการในหีบและไม่ต้องถึงมติ
.) เมื่อคุณได้เขียนสิ่งที่คุณต้องกลับไปตรวจสอบด้วย
needers เพื่อให้แน่ใจว่าคุณมี ได้อย่างถูกต้องแสดงความต้องการของพวกเขา ถ้า
needers ไม่สามารถทำให้ความรู้สึกของสิ่งที่คุณเขียนพวกเขาไม่สามารถบอกคุณถ้าคุณ
ได้มันขวา
เช่นเดียวกับที่พระเจ้าทำกับโนอาห์ที่เราทำดีกว่าถ้าเราจะอธิบายสิ่งที่เราต้องการใน
ภาษาธรรมดาและลำดับที่ชัดเจนและตรรกะ เราทำดีขึ้นเมื่อเราบอก
เรื่องราว
หนังสือเล่มนี้อธิบายถึงวิธีการเขียนเอกสารความต้องการซอฟต์แวร์ที่ใช้
เล่าเรื่องวิธีการที่เก่าแก่ที่สุดของมนุษย์และการใช้ข้อมูลร่วมกัน i
รู้ว่าคุณไม่สามารถทำเอกสารความต้องการซอฟต์แวร์เป็นเรื่องราวเป็น Excit-
ไอเอ็นจีเป็นเรือของโนอาห์หรือฟินแลนด์เกิล แต่คุณสามารถทำให้การเล่าเรื่องที่เป็น
มีส่วนร่วมและง่ายต่อการปฏิบัติตามสำหรับคนที่มีความสนใจในการแก้ปัญหา
ที่อยู่ในมือ ในการเล่าเรื่องปัญหาที่ควรจะระบุไว้อย่างชัดเจน
ที่จุดเริ่มต้นและทุกจุดที่จะนำไปสู่​​การแก้ปัญหาที่มีจุดแต่ละจุด
ต่อไปนี้จากหนึ่งไปยังอีกในลำดับตรรกะของผลลัพธ์ขึ้นอยู่กับ
มันยังช่วยให้คุณใช้เป็นจำนวนมากของภาพ
เมื่อคุณต้องการบางสิ่งบางอย่างสามัญสวยที่ผู้คนได้รับการทำ
เป็นเวลานานเช่นเก้าอี้หรือแฮมเบอร์เกอร์ที่คุณมักจะไม่ต้องอธิบาย
สิ่งที่คุณต้องการในรายละเอียดมากบางทีอาจจะมีตัวแปรไม่กี่ที่คุณจำเป็นต้องระบุ
(กับชีสไม่ทอดขนาดกลางที่หายาก) มันเป็นเรื่องที่ท้าทายมากขึ้นเมื่อคุณ
ต้องการสิ่งที่ซับซ้อนและพิเศษดังกล่าวเป็นระบบซอฟแวร์ใหม่ วิศวกร
เพียง แต่มากฝีมือและความเชี่ยวชาญให้ซอฟแวร์และพวกเขาได้
ไปโรงเรียนพิเศษที่จะเรียนรู้ภาษาใหม่และเครื่องมือ (Java, C #และอื่น ๆ บน
)วิศวกรส่วนใหญ่เหล่านี้สื่อสารกับแต่ละอื่น ๆ เกี่ยวกับสิ่งที่พวกเขา
ให้ใช้ทุกคำที่พิเศษจากภาษาใหม่เหล่านี้และสวยเร็ว ๆ นี้
คนธรรมดาไม่สามารถเข้าใจพวกเขาได้เป็นอย่างดี
ความท้าทายเมื่อพยายามที่จะเขียนเรื่องราวเกี่ยวกับสิ่งที่คุณต้องการซอฟต์แวร์
จะทำคือการให้เข้าใจถึงสองกลุ่มที่สื่อสารในรูปแบบที่แตกต่างกันมาก
:needers ของซอฟต์แวร์และวิศวกรที่ทำให้ เมื่อทั้งสองกลุ่ม
ไม่เข้าใจและเห็นด้วยกับการเล่าเรื่องราวของคุณก็จะล้มเหลว

ผลลัพธ์ (ไทย) 2:

ถ้าคุณชัดเจน และแม่นยำ คุณจะคงได้รับสิ่งที่คุณต้องการ ถ้าไม่มี
ปัญหาเมื่อสิ่งจะทำ คุณมีระเบียนที่คุณถาม และ
พื้นฐานความน่าเชื่อถือสำหรับการร้องขอการแก้ไขหรือปรับปรุง
เมื่อคุณต้องการอะไรซับซ้อน คุณต้องเขียนรายละเอียดเพิ่มเติม
เอกสารความต้องการ และ เมื่อคุณกำลังอธิบายไม่เพียงแต่คุณต้อง,
แต่ยังความต้องการของกลุ่ม คุณต้องค้นหาวิธีการรวมกลุ่มของ
needers ในกระบวนการของคุณ และระบบค้นหาสิ่งที่พวกเขาต้องการ (พระเจ้า
ไม่มีปัญหานี้ เขารู้ว่าสิ่งที่เขาต้องการในการหีบ และไม่ต้อง
ถึงช่วย) เมื่อคุณได้เขียนบางสิ่งบางอย่าง คุณต้องตรวจสอบ
กับ needers ให้แน่ใจว่า คุณได้อย่างถูกต้องได้แสดงออกถึงความต้องการ ถ้า
needers ที่ไม่เหมาะสมของสิ่งที่คุณได้เขียน พวกเขาไม่สามารถบอกคุณถ้าคุณ
ได้ขวาได้
เหมือนพระเจ้า มีโนอาห์ เราทำดีกว่าถ้าเราอธิบายสิ่งที่เราต้องการใน
ภาษาธรรมดาและลำดับชัดเจน และตรรกะ เราทำดีกว่าเมื่อเราบอก
เรื่อง
จองนี้อธิบายถึงวิธีการเขียนซอฟต์แวร์ข้อกำหนดเอกสารโดยใช้
storytelling สุดโบราณ และมนุษย์วิธีการใช้ข้อมูลร่วมกัน ฉัน
รู้คุณไม่สามารถทำเอกสารข้อกำหนดซอฟต์แวร์เป็นเรื่องเป็น excit‑
กำลังเป็นโนอาห์อาร์คหรือ Huckleberry ฟินน์ แต่คุณสามารถทำการเล่าเรื่องที่
เชื่อ และทำตามสำหรับผู้ที่มีความสนใจในการแก้ง่าย
ปัญหาที่ ในเล่าเรื่อง ปัญหาควรชัดเจนระบุ
ต้น และจุดที่ควรนำไปสู่การแก้ปัญหา กับจุดแต่ละจุด
ขั้นถัดไปในลำดับตรรกะของผลขึ้นอยู่กับ 1
มันยังช่วยถ้าคุณใช้รูปภาพมากมาย
เมื่อคุณต้องการอะไรสวยธรรมดาที่คนได้รับการ
นาน เช่นแฮมเบอร์เกอร์ หรือเก้าอี้โดยปกติคุณจะอธิบาย
สิ่งที่คุณต้องการในรายละเอียดมากขึ้น บางทีมีตัวแปรกี่ต้อง
ระบุ (มีชีส ไม่ฟรายส์ กลางหายาก) มันคือความท้าทายเมื่อคุณ
สิ่งซับซ้อน และผู้เชี่ยวชาญเช่นซอฟต์แวร์ระบบใหม่ที่ต้องการ
เดียวทำให้วิศวกรผู้เชี่ยวชาญ และเฉพาะซอฟต์แวร์ และมี
ไปโรงเรียนพิเศษการเรียนรู้ภาษาใหม่และเครื่องมือ (Java, C# และ
บน) วิศวกรเหล่านี้ส่วนใหญ่ติดต่อกันเกี่ยวกับว่าพวกเขา
ทำ ใช้คำพิเศษทั้งหมดเหล่านี้ภาษาใหม่ และสวยเร็ว ๆ นี้
คนธรรมดาไม่สามารถเข้าใจได้ดีขึ้น
ความท้าทายเมื่อพยายามจะเขียนเรื่องราวเกี่ยวกับสิ่งที่คุณต้องการซอฟต์แวร์
ทำคือ ทำให้เข้าใจกลุ่มสองที่สื่อสารมาก
วิธี: needers และวิศวกรที่ทำการ ถ้าทั้งสอง
กลุ่มเข้าใจ และเห็นชอบเรื่องของคุณ มันจะล้มเหลว

ผลลัพธ์ (ไทย) 3:

หากคุณกำลังล้างได้อย่างแม่นยำและคุณจะได้รับสิ่งที่คุณต้องการได้ หากมี
ปัญหาใดๆเมื่อเป็นสิ่งที่ทำได้คุณมีการบันทึกสิ่งที่คุณถามและ
พื้นฐานที่น่าเชื่อถือได้สำหรับการร้องขอการปรับปรุงหรือการแก้ไข
เมื่อคุณต้องการบางสิ่งบางอย่างมีความซับซ้อนคุณจะต้องเขียนเอกสาร
ข้อกำหนดรายละเอียดเพิ่มเติม และเมื่อคุณจะอธิบายถึงไม่เพียงความต้องการของคุณเอง
แต่ยังมีความต้องการของกลุ่มคุณจะต้องหาวิธีที่จะรวมกลุ่มของ
needers ในกระบวนการของคุณและระบบค้นหาออกจากสิ่งที่พวกเขาต้องการ (พระเจ้า
ไม่มีปัญหานี้ เขารู้ว่าสิ่งที่เขาต้องการในหีบและไม่ต้อง
ถึงฉันทามติ)เมื่อคุณเขียนอะไรบางอย่างคุณจะต้องตรวจสอบอีกครั้ง
พร้อมด้วย needers เพื่อตรวจสอบให้แน่ใจว่าคุณกำลังแสดงความคิดเห็นความต้องการของพวกเขาได้อย่างถูกต้อง หากสัญลักษณ์
needers ที่ไม่สามารถทำให้เกิดความรู้สึกของสิ่งที่คุณได้เขียนไว้ก็ไม่สามารถบอกคุณว่าคุณ
มันขึ้นมาทางขวา
อยู่ตามที่พระเจ้าไม่มีโนอาห์เราทำได้ดีหากเราอธิบายถึงสิ่งที่เราต้องการใน ภาษา
ธรรมดาและตามลำดับอย่างชัดเจนและแบบลอจิก เราทำได้ดีเมื่อเราบอกเรื่องราว
ที่
หนังสือเล่มนี้จะอธิบายถึงวิธีการเขียนข้อกำหนดด้านซอฟต์แวร์ที่เอกสารการใช้
เล่าเรื่องราวเสริมทักษะหมายความว่าเก่าแก่ที่สุดและของมนุษย์สำหรับการแบ่งปันข้อมูล. ผม
ทราบว่าคุณไม่สามารถทำให้ความต้องการซอฟต์แวร์เอกสารในเรื่องเป็น excit -
ไอเอ็นจีประกันชีวิตเป็นหีบของโนอาห์หรือฮักเคิล แต่คุณสามารถทำให้เสียงบรรยายที่มี
ทำได้อย่างง่ายดายและต้องปฏิบัติตามสำหรับผู้ที่มีส่วนได้เสียในการแก้ไขปัญหาที่อยู่ในมือ
ในเรื่องที่มีปัญหาที่ควรจะได้รับการกล่าวถึงอย่างชัดเจน
ที่อยู่ตอนต้นและจุดทั้งหมดจะนำไปสู่โซลูชันที่พร้อมด้วยแต่ละจุด
ต่อไปนี้จากที่หนึ่งไปยังถัดไปในลำดับแบบลอจิกขึ้นอยู่กับผลลัพธ์
และยังช่วยหากคุณใช้จำนวนมากของ ภาพ
เมื่อคุณต้องการบางสิ่งบางอย่างสวยงามทั่วไปที่มีการทำ
เป็นเวลายาวนานเช่นเก้าอี้หรือแฮมเบอร์เกอร์ที่คุณไม่ต้องอธิบาย
สิ่งที่คุณต้องการในรายละเอียดให้มากโดยปกติแล้วมีอาจจะเป็นตัวแปรสำคัญที่คุณต้องการ
ระบุ(พร้อมด้วยชีสทอดไม่มีขนาดกลางหายาก) มันเป็นเรื่องที่ท้าทายมากขึ้นเมื่อคุณ
จำเป็นต้องมีความยุ่งยากและบางสิ่งบางอย่างมีความเชี่ยวชาญเช่นระบบซอฟต์แวร์ใหม่ วิศวกร
เท่านั้นมีความชำนาญเป็นอย่างมากมีความเชี่ยวชาญและทำให้ซอฟต์แวร์และพวกเขามี
ไปโรงเรียนพิเศษในการเรียนรู้ ภาษา และเครื่องมือใหม่( Java c# และ
)วิศวกรเหล่านี้ส่วนใหญ่จะเป็นการสื่อสารกับคนอื่นแต่ละคนเกี่ยวกับสิ่งที่พวกเขา
ทำให้การใช้คำว่าพิเศษทั้งหมดออกจาก ภาษา ใหม่เหล่านี้และสวยงามอีกไม่นาน
ประชาชนคนธรรมดาไม่สามารถทำความเข้าใจรวมถึงเป็นอย่างมาก ความท้าทาย
เมื่อกำลังพยายามให้เขียนเรื่องที่เกี่ยวกับสิ่งที่คุณต้องการ
เพื่อทำได้ก็คือการทำให้เข้าใจได้ถึงสองกลุ่มที่ติดต่อสื่อสารใน
วิธีที่แตกต่างกันเป็นอย่างมากneeders ของวิศวกรและซอฟต์แวร์ที่ทำให้มัน. หาก
ทั้งสองกลุ่มไม่ได้ทำความเข้าใจและพิจารณาอนุมัติของเรื่องราวของคุณจะไม่สามารถ