Requirements Document


Please use the following outline in preparing the requirements document. This outline is adapted from the generic requirements document given on page 69 of the textbook, and you should refer to page 69 for further description of the required sections. Please adhere to this outline, to the extent of placing a stub text (\"This section has been omitted\" or "This section will be added later") for portions that are not ready (there will be two of them in the first draft due Monday) or for parts that you feel are not appropriate to your project (we'll discuss those).

Finally, please make your documents professional. Part of your grade on the documents will depend on the appearance, organization and attention to clear writing in your documents.

I've made a few modifications since we discussed this document in class the other day.


Document Title

Requirements Document for the XYZZ project

Authors

Your names here together with email addresses.

Purpose of the document

Include, in your own words, the purpose of a requirements document.

Change History

This should be a list of each change to the document together with the date the change was made and the reason for the change (i.e., respond to client's or reviewer's comments). The first entry should be the date on which the document was first turned in to me.

Table of Contents

I use \LaTeX for much of my writing, and would be happy to give an hour's lesson in its use. I'm sure that any word processor you use will have some provision for table of contents (though I've never learned how to do it in MS Word, I'm afraid).

All documents turned in as a part of this project should have these initial five sections.

Section 1: Introduction

Brief description of the problem this system solves, and how it will solve the problem. For further details on this (and the following sections), please refer to the generic document outline on page 69.

Section 2: Glossary

Definitions of technical terms. Remember that you are writing for both a technical and a non-technical audience.

Section 3: System Models

Since we won't start discussing these until Friday, this part will be due at the same time as the functional specifications (below).

Section 4: Functional Requirements Definition

Description of services provided.

Section 5: Non-function Requirements Definition

Imposed constraints, models, standards go here.

Section 6: System Evolution

Assumptions made in determining how the system will operate and how it will change in the future.

Section 7: Requirements Specification

This is the functional specification portion of the document, and will be provided later.




Return to the project home page