System Requirements Specification (SRS) Guidelines
(Based on IEEE Std 830-1984)

From: CS 445 - Software Requirements and Specification, University of Waterloo.

Last modified: Nov. 5, 1997, Jo Atlee, University of Waterloo.

0. Table of Contents

1. Introduction

• about the document/how to read document

1.1 Purpose

• intended audience
• how it is to be used - contract between vendor and customer? validation? control rest of development?
• .25-.5 pages

1.2 Scope

• what are boundaries of description
• what is being specified
• .25-.5 pages

1.3 Definitions, Notational Conventions

• high level definitions used throughout spec: ADT, caller, callee, SX4, SRS, TTRX, Acct. No...
• any notation used outside of methodology, naming conventions, extensions to methodology

1.4 References

• course handouts, notation references, CASE documentation

1.5 Overview

• brief (1 sentence) description of other sections

2. General Description

• introduction to product

2.1 Product Perspective

• relationship between system and its environment
• context diagram
• expand a bit on scope section, what are the boundaries of the system?

2.2 Product Functions

• brief (1-3 sentence) descriptions of primary functions.

2.3 Characteristics of eventual users

• required background, training

2.4 Constraints

• hardware constraints
• interface limitations
• implementation, language requirements

2.5 Assumptions & dependencies

• e.g. hardware never fails, only 1 admin operator at a time...

3. Specific Requirements

3.1 External Interface Requirements

3.1.1 User Interface

• mock-ups of screens
• Input, Output Events: event name, parameters, designation, (how event is realized in environment)

3.1.2 Hardware Interface

• Input, Output Events: event name, parameters, designation, (how event is realized in environment)

3.1.3 Software Interface

3.1.4 Communications Interface

• messages between OAM and control computer
• protocol of sending messages

3.2 Behavior Requirements

3.2.1 Object Structure/Process Structure Requirements

• introduction - brief description of objects & blocks
• OMT object model
• SDL system & block specs

3.2.2 Dynamic Requirements

• introduction - brief description of processes, dynamic behavior
• OMT dynamic models
• SDL process specs, procedures, ADTs
• internal input and output events: name, parameters, designation

3.2.3 Functional Requirements

• introduction - brief description of functions, parameters, return type
• OMT functional model

3.3 Performance Requirements

• time for offhook to dial tone...

3.4 Accuracy Requirements

• bill precision
• precision of maintenance tests/voltmeters

3.5 Non-behavioral Requirements

• Availability
• Security
• Maintainability
• Portability
• Safety

4. Data Dictionary

• constants
• acronyms, abbreviations

5. Index

• or TOC for each section