bannera

Book A.
Introduction

Book B.
7150 Requirements Guidance

Book C.
Topics

Tools,
References, & Terms

SPAN
(NASA Only)

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Alias
aliasSWE-055

...

idtabs-1

1. Requirements

3.1.2.3 The project shall perform requirements validation to ensure that the software will perform as intended in the customer environment.

1.1 Notes

Requirements validation includes confirmation that the requirements meet the needs and expectations of the customer. Requirement validation is confirmation, through the provision of objective evidence, that the requirements for a specific intended use or application have been fulfilled.

1.2 Applicability Across Classes

...

f1
g1
h0
asc1
ansc1
bnsc1
csc1
bsc1
esc1
cnsc1
dsc1
dnsc0
ensc0

...

idtabs-2

2. Rationale

Requirements are the basis for a project. They identify the need to be addressed, the behavior of the system, and the constraints under which the problem is to be solved. They also specify the performance of the product to be delivered by a contracted provider of software.

...

Requirements that accurately describe the need to be solved by the project team need to be defined before the main planning and building activities begin. Validation is one way to ensure the requirements define the need completely, clearly, correctly, and consistently to give the software engineers the best chance to build the correct product. 

Validation is a process of evaluating artifacts to ensure that the right behaviors have been defined in the artifacts. The right behaviors adequately describe what the system is supposed to do, what the system is not supposed to do, and what the system is supposed to do under adverse conditions.  

...

Other reasons for validating requirements:

  • To ensure customer satisfaction with the end product.
  • To reduce costs (i.e., get it right the first time).
  • To gain confidence that the requirements can be fulfilled for the intended use.
  • To clarify meaning and expectations.

...

idtabs-3

3. Guidance

The basic validation process is shown below with the steps addressed by this requirement highlighted:

Image Removed

Panel

Validation activities are not to be confused with verification activities as each has a specific goal.  Validation is designed to confirm the right system is being produced while verification is designed to confirm the product is being produced correctly.

Requirements validation, as used in this requirement, addresses all of the following:

  • Confirmation of the correctness, completeness, clarity, and consistency of the requirements with stakeholders.
  • Confirmation that the requirements will be fulfilled by the resulting product.
  • Confirmation that implied or inherent requirements (e.g., system should do X before Y) are correctly implemented.

Validation activities are not performed in an ad hoc manner, but are planned and captured in a validation plan document.  The validation plan is typically part of a verification and validation (V&V) plan, a software V&V plan (SVVP), or is included in the Software Management/Development Plan (SMP/SDP).

All requirements need to be validated. Categories include, but are not limited to:

...

To perform complete requirements validation, multiple techniques may be required based on the nature of the system, the environment in which the system will function, or even the phase of the development life cycle.  Sample validation techniques or methods include, but are not limited to:

...

  • Demonstrating specific actions or functions of the code.
  • Use this technique to validate requirements related to questions. such as "can the user do this" or "does this particular feature work."

...

  • Relevant stakeholders investigate and review a product, such as requirements to determine if it meets preset criteria and to identify product defects.
  • Peer reviews and inspections are useful for validating documents, such as SRSs, and allow for peer discussion of the technical aspects of the document content.
  • Inspections can be informal or formal with formal inspections being more structured with specific activities, assigned roles, and defined results (metrics, defects, etc.).
  • Inspections typically cover larger volumes of information than formal reviews and only identify the issues; solutions are typically not part of the peer review/inspection process.

...

  • Analysis can be considered a "lightweight" version of running software against a simulation and involves going through the calculations without actually running the simulation in real time.
  • Analysis removes the time-related aspects of the validation, which may need to be validated using a different technique.
  • Use this technique as part of an overall validation strategy or as a precursor step to a full simulation.
  • Beta testing of new software applications.
  • Use this technique when budget and time allow, when stakeholders are hands-on, when stakeholders (primarily user groups) and project schedule are amenable to this type of testing, etc.

...

  • Drawing prototypes on paper.
  • This is a low-cost prototyping technique that might be useful in the early stages of high-level requirements development to capture and display visually the ideas and concepts or for projects that don't have the budget for prototyping in software.
  • Issues with prototyping on paper include storing for future reference and difficulty transforming into executable prototypes.
  • Typically these prototypes simply end up in requirements documents.

...

  • Modeling system behavior using use-cases to identify actors and their interaction with the system.
  • Use this technique when it is easy to identify users (both human and other systems) and services or functionality provided by the system.
  • This technique is helpful when the focus of the software defined by the requirements is on user interaction with the system because use-case models depict a problem and solution from the user's point of view, "who" does "what" with the system.

...

  • Identify conflicting requirements based on viewpoints of various stakeholders.
  • Use this technique when there is a need to identify conflicting requirements based on viewpoints or when it is important to consider requirements from multiple perspectives.

...

When validating requirements, either new or modified, consider including the following roles because all roles will review the requirements from a different perspective:

Sample Roles for Validation Activities

Customer

Developer

Interface Representative

Requirement/SRS Author

Reviewer (topic expert, safety, software assurance, etc.)
-       As appropriate, multiple Reviewers could be included, each providing a specialized perspective

When available and appropriate, checklists and documented procedures are used for the various techniques selected for requirements validation to ensure consistency of application of the technique. 

Sample Checklists and Procedures

Peer review/inspection checklists

Formal review checklists

Analysis procedures

Acceptance test procedures

Samples are included in the Resources section of this guidance, but Center procedures take precedence when conducting requirements validation activities at a particular Center.

A requirements traceability matrix may also be useful to ensure that all requirements are validated.  The matrix could include:

  • Links to higher-level requirements which identify/define user needs.
  • A place to record validation methods.
  • A place to record or reference the validation results.

...

  • Confusing management of requirements with validation of requirements.
    • Managing requirements will not ensure they are correct.
  • When using prototyping to validate requirements:
    • Failing to keep the focus on what the software is supposed to do.
    • Allowing the focus to shift to the how the system will look when it is done.
  • Failing to re-validate requirements as they change during the project life cycle.
  • Getting stakeholders with different views to agree on a single version of a requirement; interpretation can be troublesome.
  • When using visual models to bridge the communication gaps among stakeholders, only translating a limited number of requirements into visual models (often due to time or budgetary constraints).
  • Failing to link the text to visual models; both are needed for understanding.
  • Failing to use a formal process to track all versions of the requirements as they change during the project.

Additionally, it is important to confirm with stakeholders that their needs and expectations remain adequately and correctly captured by the requirements following resolution of conflicting, impractical and/or unrealizable stakeholder requirements.

While the Software Requirements Review (SRR) addresses more than just "getting the requirements right", the SRR can include that action as part of the review.

Additional guidance related to requirements validation may be found in the following related requirements in this Handbook:

SWE-029

Validation Planning

SWE-031

Validation Results

SWE-073

Platform or Hi-Fidelity Simulations

SWE-102

SW Development/Management Plan

Div
idtabs-4

4. Small Projects

Small projects need to balance the effectiveness of the available methods against available resources to validate requirements associated with software. Safety-critical requirements, human-rated requirements, and other critical requirements need to be validated with appropriately rigorous methods which are documented in the project's software development/management plan.

...

idtabs-5

5. Resources

...

toolstable

...

idtabs-6

6. Lessons Learned

A documented lesson from the NASA Lessons Learned database notes the following:

...