Change History

Completed work since the changes from NPR 7150.2B to NPR7150.2C. Includes the addition of substantial Software Assurance and Safety material. 

 1. To coincide with the release of NPR 7150.2C (on 8/2/2019), the following large changes were made to the Handbook:

• All software requirements were updated from NPR 7150.2B to NPR 7150.2C (124+ pages)
• All guidance corresponding to software requirements was reviewed and updated (124+ pages)
• All references were reviewed and updated
• SWEs retired: 22
• SWEs reserved: 27 (not used in drafts but issued in final version)
• Created "applicable-c" macro for use in in tab 1 of all project SWEs (replaces "applicable-b" macro. 

 2. In anticipation of the release of NASA-STD-8739.8 (late 2019 and early 2020), a software assurance tab was added to each NPR 7150.2C requirements page (from Chapters 3 through 5). (Total of 110 pages) Each page contains:

• Corresponding NPR requirement
• Software Assurance Required Tasks from NASA-STD-8739.8
• Expected Product(s) from Performing Tasks
• Suggested Metrics from Performing Tasks
• Guidance on How to Perform Tasks

 3. Updates to the Software Engineering Topics

Multiple changes to existing Topics. Two Topics were added and two were retired. 

 4. Added a new tab to the "D. Topics" page titled "Assurance and Safety Topics".

A total of 18 topics were added:

 5. Added a new tab (8/2020) to the "D. Topics" page titled, “Software Design Principles.”

These Principles were moved from the SPAN server. There are 17 principles pages, each containing:

• The Principle
• Example and Discussion
• Inputs from Centers Relating to the Principle
• Resources
• Lessons Learned

 6. Added a new tab (4/2021) to the "D. Topics" page titled, “Programming Checklists”

This tab consists of  10 checklists and a file with good and Bad Exception Handling Practices.

 7. Added FAQ (Frequently Asked Questions) section with questions and answers for software engineering, software assurance and safety areas. (10/2020, updated 2/2021,3/2021)

 8. Reformatted all “lesson Learned” pages to include lessons learned from other sources as well as the from the database (100+ pages)

Reformatted all pages to adhere to a common presentation of information

• Lessons Learned database
• Other Lessons Learned resources

 9. Changed Section E: Tools, References and Terms:

• Reformatted Terms Database
• Reformatted Acronyms database
• Reformatted Tools Table
• Added approximately 60 new References

10. Added the capability to link into earlier versions of the SWE Handbook: (9/2020)

• Added “Accessing Other Versions of SWEHB” tab in all 3 versions of SWEHB 

Work in Progress will be moved into the Completed Work tab once it is finished, reviewed, and approved for release. 

 1. Implement SA Metrics for topic 8.18 (April and May 2021)

• Update Topic 7.18 with SA Life Cycle Products -
  • Converted spreadsheet into text format for display in the Topic. 
  • Attach spreadsheet to Topic 8.18
• Update all SWEs with metrics. Put metrics from the spreadsheet into Tab 7.3 - Metrics (Count of SWEs affected)
• Update Topic 8.18
  • Add text version of spreadsheet into tab 2,
  • link to Excel spreadsheet attached to topic. 
• Coordinated metrics in each requirement with metrics in Master metrics file and added any missing metrics to the appropriate requirement (early August, 21

 2. Other ongoing modifications, minor rewordings, and clarifications 

• Modifications from NESC assessments
• Additional Lessons Learned
• Modify / remove references to "Classification Tool" in all three versions of SWEHB (July 2021)
• Clean up tables of referenced SWEs and Topics in tab 3 of most SWEs in all three versions (July - August 2021)
• Added definition of Integration testing to Topic 7.21; added risk probability, risk severity to risk metrics in Topic 7.14, Tab 2

3. Add Objective Evidence in all SWEs with SA tabs (May 2021)

• Add macros for Note box and definition of Objective Evidence
• Add content for Objective Evidence Notes 

 4. Add various new Topics

• 8.19 - Dead / Dormant Code and Safety-Critical Software - 6/11/2021
• 8.20 - Safety Specific Activities in Each Phase - 7/23/2021
• 8.21 - Software Hazard Causes -  10/22/2021 
• 8.22 - Hazardous Commands -  1/19/2022 

 5. Build out topic 8.16 - SA Product List (August through Dec 2022) 

• Designed areas for SA Products, consisting of an Introductory Page that has links to each of the nine major products plus one for objective evidence.
• Introductory Page is complete and has 2 completed tabs, one that maps the products and sub-products to milestones, and one that maps the products to the SASS Task in NASA-STD-8739.8
• Pages have been built with the planned tabs for each product.
• Software Assurance Plan is populated with the Introduction and tabs for SA Plan content and Safety Plan Content.  Security Plan and Resources-TBS
• IV&V Project Plan is populated with Introduction, and tabs for Content, PRBA/RBA. Resources tab-TBS
• Software Requirements Analysis (5 tabs total, 4 populated-Introduction, Requirements Analysis Techniques, Safety Requirements Analysis, Reporting Results)
• SA Status Page will be Introduction, Status Contents (Done), and additional tabs (in-work)
• Safety and Hazard Analysis (4 tabs TBS)
• Software Design Analysis (4 tabs total, completed and under review)
• Software Code Quality Analysis (5 tabs completed and under review)
• Software Testing Analysis (4 tabs TBS)
• Objective Evidence (4 tabs complete)
• Audit Report (5 tabs total, Introduction, Audit Page, Audit Metric Page, Audit Results complete, under review, Checklist matrix TBS)

 6. Created SWE History pages for all SWEs in all versions of the SWEHB (2021)

• Pages with the history, by version, are in SITE space
• All SWE pages in the current version of SWEHB have a section 1.2 History section with a link to the SWEs history page
• Covers up to SWE-223

Work in SWEHBVD. Includes preparation of the space for release as well as work unique to SWEHBVD and versions moving forward. 

 1. Create SWEHBVD based on SWEHBVC ( August 2021 thru April 2022)

• Create space and copy all content from VC to VD
• Create Theme for SWEHBVD with DRAFT in the header image
• Update internal links to ensure that they point within the SWEHBVD space
• Retire 4 SWEs
• Add new SWEs, including History pages - SWE-208, 209, 210, 212, 219, 220, 221, 222, 223
• Update SWEs and Notes from NPR 7150.2D as necessary
• Released new version SWEHBVD in April, 2022

 2. Move shared resources to SITE Resources space (August 2021 thru 2022)

Certain resources are shared among SWEHB versions. This shared content is best contained in SITE space so that changes are immediately available in all SWEHB versions. 

• Definition of Objective Evidence page moved from SWEHBVC and SWEHBVD to SITE. Updated all SWEs in two version spaces to point to the page in SITE (approximately  250 pages)
• Moved Change History to SITE - Put redirection pages in SWEHBVC and SWEHBVD
• Moved Doc Structure References reports to SITE
• Analyzing Topics to see if some are independent of NPR version and can be moved to SITE space

 3. Document SWEHB collection of spaces in SITE (September 2021 thru 2022)

• Documents overall architecture for all versions of SWEHB
• SWEHB Style Guide
• Topics Style Guide
• User Macro documentation

4. Formatting changes in SWEs and Topics (January 2022 - July 2022)

• Replace Panel macros with Note macro. This makes the item standout better: in yellow boarder box, with yellow background and Note icon. 
• Add link to SPAN for SWEs and topics that reference SPAN libraries. Add link to SWEREF-197. 
• Implement new Panel macro for large quotations. 
  • Quotes of one complex sentence or larger, are put in a blue panel,  
• General cleanup of sub-headings for all pages

5. Checklists and Guidance Assets  & Process Asset Templates (2022 )

• Started in SWEHBVC, and carrying over into SWEHBVD. Checklists and other guidance assets buried in SWEs and topics are listed in a table in the "Checklists and Guidance Lists" page, under topic "8.16 - SA Products". 
• Built "pat" template for PAT pages - reused code in "references" template
• Built reports pages for new PATs where PATs can be called out in pages just like References
• Built PAT Database in SITE to contain all PATs - reused structure from References 
• Added new Category of assets reports for grouping PATs in meaningful collections
• PAT count: 30 as of 10/19/2022 

6. Changes for NASA-STD-8739.8B (June 2022 - December 2022)

• Built a copy of NASA-STD-8739.8B in SITE. Include pages derived from this document are child pages under this document
• Updated all the sections in Topic 8.16 that include tasks from NASA-STD-8739.8 with latest latest version NASA-STD-8739,8B
• Updated all Tab 7.1 (SWEs from NPR Chapter 3) with tasks from NASA-STD-8739.8B - put in quote boxes (blue border)
• Built include pages for all SA Tasks and all Requirements in sections 4.4.2 and 4.5

7. New Topics, Updated Guidance (2022)

• New Topic added: 8.23 Software Contents for a Certification for Flight Readiness Review (CoFR) (July 2022)

• Review comments from NESC Test and Validation Team  added to 8.16 Testing Analysis (August 2022)
• 2 Checklists from NESC Test and Validation Team added to SWE-066: Test Review Checklist for Test Team Leads, and Test Review Checklist for Test Reviewers or Review Panel Members (July 2022)
• Checklist for Detection of Adversarial Actions added in SWE-210 (July, 2022)
• List of Tools for Code Coverage added to SWE-220 (August 2022)

1. New Activity View and Improvements (October 2022 - ?)

• Planning for Activity View of SWEHBVD content - reviewed at SwWG meeting, Feb, 2023 at KSC (Feb 2023)
• Addition of a blog for SWEHBVD in Introduction page and "New in SWEHB" link to History page ( Feb 2023)
• Reorganization of Requirements Buttons and Pages (Mar 2023)
  • Add a way to see all SWEs in numeric order
  • Revise top block of text to include expand sections
• Plan for reorganization of buttons in header to add Activities (Mar 2023 - ?)
• Cleanup of "Tools, References, and Terms" page (planned)

2. Reformatting SWEHB pages (2023)

• Add "New in SWEHB" link to all main pages (Feb 2023 )
• Add "Related Links" table to all appropriate pages ( Feb - June 2023)
  • SWEs - in tab 3 and tab 7
  • Topics - depends on the tab layout
• Subheadings in all SWEs, tab 3 (Jan - March 2023)
• Add "Center Process Asset Libraries" section to SWEHBVD - includes note about SPAN, link to SPAN in NEN, SPAN links to appropriate SPAN page based on the subject matter of the SWE or Topic ( Feb - June 2023)
  • SWEs - in tab 3 and tab 7
  • Topics - depends on the tab layout
• Add "Associated Activity" section ( Feb - June 2023)
  • SWEs - in tab 1 - hidden until formal rollout of activities
  • Topics - in Resources tab
• Buildout of Activity pages as additional view of SWEs, Topics and other related materials based on Life Cycle phases (Mar 2023 - In Progress 2023)

3. New Topics, Updated Guidance (2023)

• Topic 8.24 - Software Assurance Risks - similar to 7.09 in layout, reference 7.19 for content (October 2023 - In Progress)

4. Checklists and Guidance Assets  & Process Asset Templates (2023 )

• Built list of ToDo items into PAT ToDo List page - includes completed PATs as well as PAT content found in SWEHBVD pages that could be converted into a PAT

5. Document SWEHB collection of spaces in SITE (2023)

• Documented PAT creation and maintenance
• Documented changes to Activities view of SWEHBVD

6. Topic changes (2023)

• Renumber topics into a 4 character prefix in the title to facilitate use of references macros (eliminate special key word and extra coding to build references table)
  • Completed work in SWEHBVD, SWEHBVC, SWEHBVB, 7150 - July 2023
  • Pages that were re-titled nave a copy of the old page with a redirect to the new page s that old links and bookmarks will get users to the correct new page

7. Blog entries in 2023

• Work Product Minimum Content Pages - 5.xx Series of Topics
• Software Design Principles Are Now Numbered Topics
• SA Tasking Checklist Update - Topic 8.15 in SWEHBVC and SWSEHBVD
• MC/DC Testing Updates - updates to SWE-219 and Topic 7.21
• Updated Requirements Pages - added option to view all SWEs in numeric order

8. Generic Topics

• Reformatting topics that are not specific to a particular version of SWEHB. Includes removing links and putting the page into SITE space while keeping an "Include-Page" macro in the SWEHB space  so that the space header of properly retained.