คำตอบสั้น ๆ : 830-1998 ไม่ใช่มาตรฐานเป็นแนวทางปฏิบัติที่ดีที่สุดสำหรับวิธีการเขียน SRS ในรูปแบบของปี 1998
ฉันไม่พบว่ามันถูกแทนที่อย่างไร (แม้จะมีการค้นหาขั้นสูงของ IEEE :()
แต่ฉันคิดว่าเป็นเพราะวิธีการทั้งหมดที่เราระบุข้อกำหนดมีการเปลี่ยนแปลงอย่างมากในช่วงไม่กี่ปีที่ผ่านมา
ดังนั้นจากนี้ไปฉันพยายามตอบคำถามที่ปรับเปลี่ยนเล็กน้อย:
แนวปฏิบัติเชิงอุตสาหกรรมที่ดีที่สุดคืออะไร / แนวปฏิบัติที่ดีที่สุดที่แนะนำเกี่ยวกับการเขียน SRS ในรูปแบบของปี 2012 คืออะไร
ในวิธีการแบบคลาสสิก:
ฉันมักจะใช้คำแนะนำ IEEE 1471 สำหรับเอกสารประกอบซอฟต์แวร์แม้ว่าจะถูกแทนที่ด้วย ISO / IEC 42010 เมื่อเร็ว ๆ นี้นี่เป็นเอกสารที่ซับซ้อนมากส่วนใหญ่จะใช้สำหรับการส่งมอบถึงแม้ว่ามันจะมีความต้องการเป็นส่วนใหญ่ก็ตาม เอกสารสไตล์ ISO ใหม่)
เป็นหนังสือที่ดีในระดับปานกลางในเอกสารอย่างเป็นทางการDocumenting ซอฟท์แวสถาปัตยกรรม , หนังสือดีที่น่าแปลกใจคือหนังสือ Iconix เก่าและคลาสสิกเก่าคือเบิร์นของการเขียนที่มีประสิทธิภาพกรณีการใช้งาน
เกี่ยวกับวิธีการทำจริงในอุตสาหกรรมวันนี้:
ความจริงที่จะบอกเอกสารโครงการอย่างเป็นทางการโดยเฉพาะอย่างยิ่งเอกสารข้อกำหนดถูกฆ่าตายส่วนใหญ่อยู่ในยุคของ Agileเนื่องจากAgile Manifestoไม่สนับสนุนเอกสารที่เป็นทางการ ไม่มีหนึ่งเดียวสเปคอย่างเป็นทางการที่มีขนาดใหญ่ แต่มีการเรียกว่าเป็นเรื่องที่ผู้ใช้ , backlogs สินค้าและเช่น นี่เป็นเพราะการพัฒนาซ้ำแล้วซ้ำอีกมีการระบุคุณสมบัติเพียงไม่กี่อย่างในแต่ละรอบ 2-4 สัปดาห์ หนังสือที่มีชื่อเสียงเป็นเรื่องที่ผู้ใช้สมัครแล้ว
มีข้อกำหนดที่เรียกว่า"executable" ซึ่งเป็นทางการเนื่องจากเป็นภาษาเฉพาะโดเมน (DSL) สำหรับการทดสอบ พวกเขาไม่ได้ดีหรือแย่ไปกว่าOCLของ UML แต่อาจเข้าใจได้ง่ายกว่า ส่วนใหญ่เรียกว่ากรอบการทำงานของ BDD และตัวอย่าง ได้แก่FitNesse , แตงกวา , จัสมิน - คุณจะพบสิ่งเหล่านี้มากมาย นอกจากนี้ยังมีหนังสือที่มีชื่อเสียงเกี่ยวกับ BDD และ TDD โดยทั่วไป
นอกจากนี้ข้อมูลจำเพาะโดยวิศวกรซอฟต์แวร์ถูกแทนที่โดยการออกแบบ UXรวมถึงสถาปัตยกรรมข้อมูลและการออกแบบการโต้ตอบดังนั้นจึงไม่ได้ทำโดยคนที่สามารถใช้รหัสได้ในปัจจุบันซึ่งอาจนำไปสู่ความขัดแย้งในบางครั้ง นี่เป็นตัวอย่างที่ไม่เลวเกี่ยวกับลักษณะที่ปรากฏ (ไม่ใช่มาตรฐาน!) แต่คุณจะพบสิ่งต่างๆได้มากขึ้นในชุมชน UX / การโต้ตอบ แต่ก็มีไซต์การแลกเปลี่ยนสแต็กทั้งแยกต่างหากสำหรับพวกเขา พวกเขามีมาตรฐานของตนเองแนะนำวิธีปฏิบัติที่ดีที่สุด ฯลฯ
แต่ถ้าคุณต้องการใช้วิธีการแบบเดิมเช่น สำหรับงานมหาวิทยาลัย
โดยทั่วไปให้ลองปฏิบัติตาม IEEE 830 (ไม่สามารถหาได้จากหน้าเว็บของพวกเขาสิ่งที่มันถูกแทนที่ด้วยแม้ว่า IEEE จะไม่ดีกับสิ่งนี้ แต่ฉันคิดว่ามันเป็นเพราะมันไม่สำคัญอีกต่อไป) และให้แน่ใจว่าคุณลอง ในการบันทึกข้อมูลที่เป็นประโยชน์ (เช่นฉันไม่คิดว่ารูปตัวละครเดี่ยวติด -> ฟองเดียวกับคำกริยาที่ถือว่าเป็นประโยชน์) ซึ่งเป้าหมายโดยรวมของผู้ใช้ช่วงโดยรวมของผู้ใช้และวิธีการโดยรวมของ การใช้งานสามารถสร้างขึ้นใหม่ได้ตลอดเวลา
ทำไมคุณถึงแนะนำหนังสือ ทำไมคุณไม่แสดงให้ฉันเห็นมาตรฐานแทน?
อีกครั้งฉันเดาว่าเอกสารนี้เป็น "แทนที่" เพราะวันนี้เรามีความสับสนวุ่นวายเล็กน้อยเกี่ยวกับข้อกำหนดของข้อกำหนด: มีมุมมองมากมายเกี่ยวกับวิธีที่ควรทำ
ไม่มีอำนาจเดียวที่สามารถที่จะบอกคุณคือ: "นี่คือวิธีการรายละเอียดที่ควรจะทำ" มีแนวทางปฏิบัติที่ดีที่สุดและฉันพยายามที่จะให้รายชื่อตัวแทนของเอกสารและเส้นทางแก่คุณแม้ว่าจะไม่สมบูรณ์และอาจมีอคติส่วนตัว
ในตอนท้ายของวันสิ่งที่สำคัญคือเอกสารที่คุณสร้างขึ้นสามารถบรรลุเป้าหมายทั้งหมดที่ทุกคนที่เคยอ่านด้วย : สิ่งที่ผู้คนต้องการเห็นสิ่งที่ผู้คนจำเป็นต้องรู้เพื่อทำความเข้าใจข้อกำหนด มีการอธิบายไว้ค่อนข้างดีในหนังสือเหล่านี้และสิ่งเหล่านี้เป็นแนวทางปฏิบัติที่ดีที่สุดเกี่ยวกับสิทธิของตนเองแม้ว่าจะอยู่ในชุมชนที่เล็กกว่าชุมชนไอทีที่ไม่มีการแบ่งแยกซึ่งเราอาจเคยมีในปี 1998