| IEEE software life cycle |
|---|
Asoftware requirements specification (SRS) is a description of asoftware system to bedeveloped. It is modeled after thebusiness requirements specification(CONOPS). The software requirements specification lays outfunctional andnon-functional requirements, and it may include a set ofuse cases that describe user interactions that the software must provide to the user for perfect interaction.
Software requirements specifications establish the basis for an agreement between customers and contractors or suppliers on how the software product should function (in a market-driven project, these roles may be played by the marketing and development divisions). Software requirements specification is a rigorous assessment of requirements before the more specific system design stages, and its goal is to reduce later redesign. It should also provide a realistic basis for estimating product costs, risks, and schedules.[1] Used appropriately, software requirements specifications can help prevent software project failure.The software requirements specification document lists sufficient and necessary requirements for the project development.[2] To derive the requirements, the developer needs to have a clear and thorough understanding of the products under development. This is achieved through detailed and continuous communications with the project team and customer throughout the software development process.
The SRS may be one of a contract'sdeliverabledata item descriptions[3] or have other forms of organizationally-mandated content.
Typically a SRS is written by atechnical writer, asystems architect, or asoftware programmer.[4]
Software requirement specifications are already used in software development processes as early as 1975.[5]
The purpose and content of software requirement specifications was formalised in 1983 by theIEEE. The standard was published in 1984 as IEEE-830-1984 and approved byANSI.[6] It was revised in 1993 and 1998, before being superseded by an international standard.[7][8] This standard aimed at providing criteria for a good SRS, and recommendations about its content. It recognised the benefits of prototyping for the requirement engineering. It propose an example of structure and several variants.
TheISO/IEC/IEEE 29148 standard "Systems and software engineering —Life cycle processes — Requirements engineering" superseded IEEE 830 in 2011.[8] The current revision is from 2018. This standard is broader as it covers also requirement quality criteria, requirement management processes, and business requirement specification (BRS), as well as stakeholder requirement specification (StRS).[9] It proposes a slightly changed example structure.
An example organization of an SRS is as follows:[10]
It would be recommended to address also verification approaches planned to qualify the software against the requirements, for example with a specific section with a structure that mirrors the section on specific requirements.[9]
Requirements should strictly be about what is needed, independently of the system design, and not how the software should do it.[9] Individual requirements shall hence be necessary, appropriate, and unambiguous. A set of requirements shall moreover be complete, consistent, feasible, and comprehensible.
Following the idea ofcode smells, the notion ofrequirements smell has been proposed to describe issues in requirements specification where the requirement is not necessarily wrong but could be problematic.[11] Examples of requirements smells aresubjective language,ambiguous adverbs and adjectives,superlatives andnegative statements.[11] Comparative phrases, non-verifiable terms or terms implying totality should also be avoided.[9]
