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

...

idtabs-1

1. Requirements

3.5.5 The project shall deliver to the customer the as-built documentation to support the operations and maintenance phase of the software life cycle.

1.1 Notes

NPR 7150.2, NASA Software Engineering Requirements, does not include any notes for this requirement.

1.2 Applicability Across Classes

Classes F and G are labeled with "X (not OTS)." This means that this requirement does not apply to off-the-shelf software for these classes.

...

f*
g*
h0
ansc1
asc1
bnsc1
csc1
bsc1
esc1
cnsc1
dnsc0
dsc1
ensc0
Div
idtabs-2

2. Rationale

The goal of software development is to provide a software product to the customer. To ensure proper understanding, use, and maintenance of the delivered product, the project team needs to provide as-built documentation, i.e., documentation that matches the delivered product, to the customer.

NPR 7150.2 includes another, similar, requirement for delivered documentation. SWE-077 applies to almost all classes (see the guidance for SWE-077 in this Handbook) and has a lot of leeway regarding what documentation exists. This requirement, SWE-078, is oriented toward the higher classes and specifies as-built or final documentation.

...

idtabs-3

3. Guidance

Panel

It is important that the Version Description Document (VDD), user documentation, and design documentation, in particular, describe the as-built and delivered software.

...

Once the project team establishes the set of documentation to be delivered with the software, the team keeps documents up-to-date throughout the project life cycle to avoid any delays in delivery. Near the end of the project life cycle the team updates any inconsistent documentation to ensure it includes the information needed to maintain the software in the future.

...

The project team needs to fully describe in the contract the delivery package content requirements for a contracted software provider to ensure the acquirer receives all critical information, including as-built documentation, required to operate and maintain the software.

Note

Consult Center Process Asset Libraries (PALs) for Center-specific guidance related to delivery of as-built software documentation.

Additionally, guidance related to software delivery, including as-built software documentation, may be found in the following related requirements in this Handbook:

...

SWE-038

...

Acquisition Planning

...

SWE-077

...

Deliver Software Products

...

SWE-116

...

Software Version Description

Div
idtabs-4

4. Small Projects

No additional guidance is available for small projects. The community of practice is encouraged to submit guidance candidates for this paragraph.

...

idtabs-5

5. Resources

...

toolstable
Div
idtabs-6

6. Lessons Learned

No Lessons Learned have currently been identified for this requirement.