When certain documents are used in the SWEHB, it is convenient to have a copy of the document in the Document Archive. When it is brought into the Archive it is decomposed into pieces that can be used in many places in the SWEHB. Usually, pieces are used in many pages throughout the a SWEHB version. It is easier to maintain document integrity by pulling in a piece with an Include-Page macro than to manually copy and paste it from the parent document.
The process of copying a document into the Archive and disassembling it is described below.
3.1 Selecting a Document to Archive
Only those documents that are static and have many pieces that will be quoted in the SWEHB in many places should be Archived.
- Static means the document is in it's final, released form. It would not be very productive to archive many draft documents and then have to update all the places where the pieces are used throughout a SWEHB Version.
- "many pieces" means there are lots of small items in a document that will be quoted in SWEHB pages. For example, NPR 7150.2 has several paragraphs that are used in other pages of the SWEHB. NASA-STD-8729.8B has many requirements and SA Tasks that are included in pages throughout the SWEHBVD version.
The documents that are currently in the Document Archive include:
- NASA-STD-8719.29 — NASA Technical Standard 8719.29, Approved: 2023-12-11 Basline - NASA Technical Requirements for Human-Rating. Full text of this NPR as taken from NODIS. Assembled from component pieces beneath this page.
- NASA-STD-8739.8A — NASA Technical Standard 8739.8A - Approved 2020-06-10 - SOFTWARE ASSURANCE AND SOFTWARE SAFETY STANDARD. Full text of this NPR as taken from NODIS. Assembled from component pieces beneath this page.
- NASA-STD-8739.8B — NASA Technical Standard 8739.8B - Approved 2004-27-08 - SOFTWARE ASSURANCE AND SOFTWARE SAFETY STANDARD. Full text of this NPR as taken from NODIS. Assembled from component pieces beneath this page.
- NPR 7150.2C — NASA Procedural Requirements NPR 7150.2C - Approved 2019-08-02 - NASA Software Engineering Requirements. Full text of this NPR as taken from NODIS. Assembled from component pieces beneath this page.
- NPR 7150.2D — NASA Procedural Requirements NPR 7150.2D - Approved 2022-03-08 - NASA Software Engineering Requirements. Full text of this NPR as taken from NODIS. Assembled from component pieces beneath this page.
3.2 Disassembly and Reassembly of a Document
3.3 Using A Piece Of A Document In A SWEHB Page
When you need to display a piece of a archived document in a SWEHB page, Use an "Include-Page" macro.
For example, the NASA software Classification structure is a list of Classes of software taken from paragraph 2, Figure 1 of the NPR 7150.2D document. That table is in the 2D-P.2 Fig 1 child page under NPR 7150.2D in the Document Archive. It is shown in the note box below.
NASA-Wide Software Classifications
Class A Human-Rated Space Software Systems
Class B Non-Human Space-Rated Software Systems or Large-Scale Aeronautics Vehicles
Class C Mission Support Software or Aeronautic Vehicles, or Major Engineering/Research Facility Software
Class D Basic Science/Engineering Design and Research and Technology Software
Class E Design Concept, Research, Technology, and General Purpose Software
Class F General Purpose Computing, Business, and IT Software
Notes: It is not uncommon for a project to contain multiple systems and subsystems having different software classes.
The include page macro that was used to fill the note panel above is shown in the note panel below:
