There are a Variety of Specifications Presented Throughout the Industry to Capture Requirements.

The requirements document (specification), the result of analysis, sets the stage for the entire and/or any process/phase/activity (design, implementation, etc.) within the development process or life cycle. It is a configuration identification document as well as the design specification/document. The requirements document contains functional/capability, design, interface, data, and other product (software/application/system) requirements. Although it is a living document, a requirements document records the agreements and decisions reached between the contractor, client/customer, and users. This begins the requirements management process/configuration management.

A requirements document may record agreements and decisions related to a project and product (system, software, application, database, web site, network, etc.). Signed by the author of the document and approved by the developer, user representative, PM and customer/client/sponsor. The business, functional/capability, and feature requirements must be complete enough to commit to executing the remaining development process (i.e., design, construction, etc.). Each paragraph in the document will/should be numbered/identified. Each requirement should be identified. Each system, software, application and it modules or components should be identified. The web site should be identified. A change page/log should be inserted in the document. A traceability matrix should be inserted in an appendix. All requirements must be stated with “Shall”, “must” and intent with “will”. For consistency, consider having one section identified for all product requirements. Many companies do/should have some type of methodology and templates that are used for the enterprise. Most can be tailored and modified for the particular project and product. A requirements document can be 50 to 100 pages for small/medium size products or hundreds to thousands pages for large products. In the aerospace environment volumes have been prepared.

Basic Content

  1. Introduction Document Overview

    Terms, acronyms, abbreviations, and definitions

    Usually a good idea to have up front to allow stakeholders an opportunity to familiarize themselves with common terms and definitions before reading the specification/document. If extensive, may be included as an appendix.) Referenced and Applicable Documents

  2. Project SummaryIncluding: Implementation approach for development (based on configuration management/deliverables. The development process.)

    Assumptions

    (Related to project, organization, technology, the entire development process (or individual process (e.g., design)), and people.)

    Constraints (Related to project, architecture/design, standards/regulations, technology, etc.)

    Risks (initially identified risks and preparation of a risks management plan)

    (Related to project, each development process (such requirements, design,

    implementation, etc.), technology, etc.

  3. Product Overview/General Requirements/Capabilities (After a requirements is identified it can be fulfilled by an individual or group function/functions, class/object, or components. Each requirement for the software/application can be described at these levels). Described inperformance measurable terms.) Presented in table form for the purpose of presentation.

 

 

 

 

 

Traditional

 

Design goals

Functional RequirementsRequired states and modes Function/Capability

External Interface

Internal Interface Internal Data

Non-functional Requirements

Feature requirements

Quality requirements

(such as non-functional requirements) (Testability, Correctness, Scalability, Usability, Reliability, Efficiency (but performance requirement may be included underfunction/capability), Scalability, Portability, Flexibility, Integrity, Interoperability, and Maintainability.

The “ilities”plus (e.g., correctness)

 

Conversion Reporting

Adaptation

Access Control

User Help

Safety Security and Privacy

Legal

Cultural/Political

Programming and coding

(Each requirements method, function, capability, etc. application and its tier environment shall state which language will be used for implementation (i.e., GUI, Business/processes, database Services))

 

 

Testing requirements

(Test planning requirements and types of testing to be performed (i.e., development including functional/qualification, system,and acceptance testing. May include information concept or usability testing or a focus or pilot test)

Environment

(Hardware/Software/Network/

Infrastructure)

Computer resource

Deployment Strategy

Close Out Criteria

Personnel (Staff and Technical Support) – related

Training-related

Deployment

Maintenance/Support

Logistics-related

Other requirements

Packaging requirements

Precedence and criticality of Requirements

Future consideration:

(requirements/expectations not included for implementation incurrent

project but can be considered for future change and enhancements)

 

 

 

 

 

 

 

Object Oriented

 

Web Site Development

 

Requirementswill Include:

Use Cases

Actors/Roles

Function/Capability

(Each requirements methods, function, capability, etc. will be expressed

in object/class terms.)

 

Application

and its tier environment shall state which language/ conventions will

be used for implementation

(i.e., GUI, Business/processes, and database Services))

 

Requirementswill include:

Features/Services

(for Web site)

Site Users/ActorsFunction/Capability

(To include interface with other system, processes/applications

and databases)

Look and Feel Include requirements for applications that are

accessed through the website.

 

  1. Qualification Methods(Each requirement (in section three for this example) shall be validated

    by one of the following methods: test, analyst, inspection, demonstrate,

    or observation.) Can be identified by each requirements or detailed

    here)

  • Requirements traceability (matrix) (Can be put in an appendix)(Traceability should be from basic business requirements to requirements

    and through design, implementation, test, etc. When a requirement can

    not traced to a specific business or system requirement, it can/should

    be traced to a general requirement or business decision(s) (to account

    for all requirements). Knowing that all requirements can not be validated

    by test, each requirements

    Qualification method should be identified

  • Comments

    Leave a Reply