Clear Communication in Requirement Engineering
"Explore the importance of clear technical communication in requirement engineering, software development process, goal of SRS, overall SW development cost, current practices for SW development, and tips for writing good SRS. Understand the significance of precise communication for successful software projects."
Download Presentation
Please find below an Image/Link to download the presentation.
The content on the website is provided AS IS for your information and personal use only. It may not be sold, licensed, or shared on other websites without obtaining consent from the author. Download presentation by click this link. If you encounter any issues during the download, it is possible that the publisher has removed the file from their server.
E N D
Presentation Transcript
Requirement Engineering: Necessity of Clear Technical Communication 1 Quoted from by Ike Kim ( ) @ ABC Tech
Software Development Process One reason why SRS sho uld be writte n carefully Requirement Analysis Test Maintenance Design Implementation Software Des ign Specificat ion (SDS) Software Re quirement S pecification (SRC) Source Code User Manual AlphaBeta RC The only chance to quite the project 2
Goal of SRS: To develop SW fast and cheap We cannot describe specification of SW before implementing it v.s. We can describe specification of SW before Misunderstanding of SRS 1. We don t describe SRS not because we don t know SRS is useful 2. We cannot describe SRS before we implement SW 3. SW is too simple to describe SRS 4. I am too busy to describe SRS 5. We don t need SRS because we use Agile process 6. We don t need a formal SRS because it will change anyway 7. 3
Overall SW Development Cost Mature Personal Developer Mature Company SW requirement analysis SW design SW implementation Immature developer/company Immature developer/company w/ poor SRS 4
Current Practice for SW Development SW developers have to follow systematic disciplines for building and analyzing software with high quality This class focuses on the analysis activities 5
How to Write Good SRS To understand the universe at the deepest level, we need to know not only how the universe behaves, but why The Grand Design by Steven Hawking Precise meaning: not only how, but also WHY (context, purpose, etc.) Ex1. I will support MS word file format. Ex2. I will support only MS word file format. Ex3. I will not support any other format than MS word file format. Ex4. I will not support any other format than MS word file format at least in 5 years Ex5. I will not support any other format than MS word file format at least in 5 years because no customer will need it Ex6. I will not support any other format than MS word file format at least in 5 years because it cost USD XXX D C B A A+ Must v.s. Shall v.s. May A+
Ex. Requirement on Retail Chain Management Software Find ambiguous points in the following requirement If the sales for the current month are below the target sales, then a report is to be printed, unless the difference between target sales and actual sales is less than half of the difference between target sales and actual sales in the previous month or if the difference between target sales and actual sales for the current month is under 5 percent. 7
How to Write Precise Technical Document Learning formal logic helps significantly Differential equation is a communication language for mechanical engineers Formal logic is a communication language for software engineers Formal logic has mathematical syntax v.s. and semantics which are precise and not ambiguous ex. a maximal element ? is defined as ?.? < ? v.s. a maximum element ? is defined as ?.? > ? Although it takes time to learn and write down documents in formal logic than natural languages, the overall cost is cheaper Documents written in formal logic can be machine-processed and utilized for various purposes 8
