Software Requirements Specification Document

Quality Assurance Criteria


General QA Criteria

Content / Format

The instructor has provided a recommended document format to follow.

Correctness

The document must be technically correct. The content of each section must fulfill the purpose for which it is intended. All diagrams must follow the appropriate notation.

Writing

The document must be well written.  The writing must meet the standards of the Cal Poly Writing Proficiency Exam level 4 or greater. If you have questions about writing style, refer to a standard style guide such as:  MLA Handbook for Writers of Research Papers.
 

General Characteristics of Good Requirements


Clarity
It is essential that the requirements be clear to all readers so as to prevent ambiguity and misinterpretation.

Completeness
A correct, complete set of requirements is one that correctly and completely states the desires and needs of the sponsor. If the requirements are incorrect, the software may meet the requirements as stated, but will not do what the sponsor wants it to do. If the requirements are incomplete, the software may do only part of what the sponsor hoped it would do. Consistency
Consistency is obtained if the requirements do not contradict each other. Inconsistency results when one requirement contradicts another. Traceability and Modifiability
Ultimately every aspect of the finished system should be able to be traced back to the requirements.  Therefore this document should be organized to facilitate tracing the requirements into subsequent work products.  An SRS is modifiable to the extent that requirements changes can be made easily and consistenlty while retaining its structure and style. Verifiability
The requirements must be verifiable in two ways: do the requirements satisfy the sponsor's needs, and does the system satisfy the requirements? In the first case, the requirements must be compared to the sponsor's desires and needs. Do the requirements correctly and completely specify the sponsor's desires and needs? In the second case, once the system has been developed, it must be compared to the requirements. Does the system meet the requirements as they are stated?

Technical Criteria

Analysis Model

Data Dictionary

External Interfaces

Engineering Analysis (Tradeoffs)


Change History
10/18/03   JD   Reworded Engineering Analysis section